Metadata-Version: 2.4
Name: context-bridge-py
Version: 0.3.0
Summary: Universal session memory for AI agents — capture, index, retrieve
Author-email: Yunare Maia <yunare@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/yunaremaia/context-bridge
Project-URL: Repository, https://github.com/yunaremaia/context-bridge
Project-URL: Issues, https://github.com/yunaremaia/context-bridge/issues
Project-URL: Changelog, https://github.com/yunaremaia/context-bridge/blob/main/CHANGELOG.md
Keywords: ai-agent,memory,context,session,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.5.0
Requires-Dist: rich>=15.0.0
Requires-Dist: pydantic>=2.13.5
Provides-Extra: dev
Requires-Dist: pytest>=9.1.1; extra == "dev"
Requires-Dist: pytest-cov>=7.1.0; extra == "dev"
Requires-Dist: ruff>=0.16.9; extra == "dev"
Requires-Dist: tomli>=2.0.1; python_version < "3.11" and extra == "dev"
Dynamic: license-file

# context-bridge — Universal Session Memory for AI Agents

**Capture. Index. Retrieve.** A local-first context layer that works with any AI coding agent.

[![CI](https://github.com/yunaremaia/context-bridge/actions/workflows/ci.yml/badge.svg)](https://github.com/yunaremaia/context-bridge/actions) [![License](https://img.shields.io/github/license/yunaremaia/context-bridge)](https://github.com/yunaremaia/context-bridge/blob/main/LICENSE) [![Stars](https://img.shields.io/github/stars/yunaremaia/context-bridge)](https://github.com/yunaremaia/context-bridge) [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/) [![Release](https://img.shields.io/github/v/release/yunaremaia/context-bridge)](https://github.com/yunaremaia/context-bridge/releases/latest)

---

## The Problem

Every AI coding agent (Claude Code, Codex, OpenCode, Hermes, Aider) forgets everything between sessions. You re-explain your project, re-state architecture decisions, and re-teach preferences every single time. Existing solutions are locked to one agent or require manual maintenance.

## The Solution

`context-bridge` is a universal, local-first memory layer that:

- **Captures** sessions from any agent automatically
- **Indexes** decisions, patterns, lessons in a local SQLite database
- **Retrieves** relevant context when you start a new session
- **Works with** Claude Code, Codex, OpenCode, Hermes, Aider — anything that writes logs

No cloud. No API keys. No vendor lock-in.

## Quick Start

_Get started in 5 minutes_:

```bash
pip install git+https://github.com/yunaremaia/context-bridge.git

# Initialize in your project
context-bridge init

# Index existing agent sessions
context-bridge index ~/.claude/projects/

# Query memory
context-bridge recall "How did we handle authentication?"

# Inject context into new session
context-bridge inject --agent claude
```

> **Not yet on PyPI.** Install from git with the line above.

## Architecture

```
~/.context-bridge/
├── sessions/           # Captured session transcripts
├── index.db            # SQLite FTS + metadata
├── memories/           # Consolidated memories
└── config.yaml         # Per-project config
```

## Why Now?

- 67k+ MCP servers deployed, AI agents everywhere
- No open-source universal memory layer exists
- Show HN validation: hmem, Engram, Memobase all trending
- Every developer using AI agents has this problem

## Sponsoring

`context-bridge` is MIT licensed and free to use. If it earns a permanent place in your setup, you can support continued maintenance via GitHub Sponsors or by sending SOL to the project treasury wallet:

```text
Eeztv1nCYUt1fwGWpzKC948gaWfjejYCAuLtUMgzDWbW
```

Funding platforms are configured in [`.github/FUNDING.yml`](.github/FUNDING.yml).

If this tool is useful to you, a star helps other people find it.

## Related tools

- **[driftcheck](https://github.com/yunaremaia/driftcheck)** — detect version drift between docs and toolchain files
- **[mcp-guard](https://github.com/yunaremaia/mcp-guard)** — audit MCP servers for unsafe permissions
- **[memwatch](https://github.com/yunaremaia/memwatch)** — health-check and prune agent memory stores
- **[agent-workspace](https://github.com/yunaremaia/agent-workspace)** — isolated workspaces per AI agent session

Part of a family of focused, single-purpose developer tools — each one does one thing
and does it well.

## License

MIT
