Metadata-Version: 2.4
Name: contextfs
Version: 0.2.22
Summary: Universal AI memory layer - cross-client, cross-repo context management with RAG
Project-URL: Homepage, https://github.com/MagnetonIO/contextfs
Project-URL: Repository, https://github.com/MagnetonIO/contextfs
Author: The YonedaAI Collaboration
Author-email: Matthew Long <mlong@contextfs.ai>
License: MIT
Keywords: agents,ai,claude,codex,context,gemini,llm,mcp,memory,rag
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: alembic>=1.14.0
Requires-Dist: anthropic>=0.40.0
Requires-Dist: bcrypt>=4.2.0
Requires-Dist: chromadb>=1.0.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: gitpython>=3.1.43
Requires-Dist: jsonschema>=4.23.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: openai>=1.50.0
Requires-Dist: pydantic-settings>=2.6.0
Requires-Dist: pydantic>=2.10.0
Requires-Dist: pyjwt>=2.9.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: rich>=13.9.0
Requires-Dist: sentence-transformers>=3.0.0
Requires-Dist: sse-starlette>=2.0.0
Requires-Dist: tiktoken>=0.8.0
Requires-Dist: typer>=0.15.0
Requires-Dist: uvicorn>=0.32.0
Provides-Extra: all
Requires-Dist: asyncpg>=0.30.0; extra == 'all'
Requires-Dist: fastapi>=0.115.0; extra == 'all'
Requires-Dist: fastembed>=0.4.0; extra == 'all'
Requires-Dist: psycopg2-binary>=2.9.10; extra == 'all'
Requires-Dist: stripe>=8.0.0; extra == 'all'
Requires-Dist: uvicorn>=0.32.0; extra == 'all'
Requires-Dist: websockets>=14.0; extra == 'all'
Provides-Extra: cloud
Requires-Dist: stripe>=8.0.0; extra == 'cloud'
Provides-Extra: dev
Requires-Dist: mypy>=1.13.0; extra == 'dev'
Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
Requires-Dist: pytest>=8.3.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Requires-Dist: stripe>=8.0.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.27.0; extra == 'docs'
Requires-Dist: pymdown-extensions>=10.12; extra == 'docs'
Provides-Extra: fast
Requires-Dist: fastembed>=0.4.0; extra == 'fast'
Provides-Extra: gpu
Requires-Dist: fastembed-gpu>=0.4.0; extra == 'gpu'
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.30.0; extra == 'postgres'
Requires-Dist: psycopg2-binary>=2.9.10; extra == 'postgres'
Provides-Extra: web
Requires-Dist: fastapi>=0.115.0; extra == 'web'
Requires-Dist: uvicorn>=0.32.0; extra == 'web'
Requires-Dist: websockets>=14.0; extra == 'web'
Description-Content-Type: text/markdown

# ContextFS

**Persistent Memory for AI Agents** - Give your AI tools memory that persists across sessions.

[![PyPI](https://img.shields.io/pypi/v/contextfs)](https://pypi.org/project/contextfs/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

**[Full Documentation](https://contextfs.ai/docs)** | **[Get Started](https://contextfs.ai)**

## Install

```bash
# With pip
pip install contextfs

# With uv (recommended)
uv pip install contextfs

# Run directly without installing
uvx contextfs
```

## Quick Start

```bash
# Initialize your repo for indexing
contextfs index init

# Save a memory
contextfs memory save "Use PostgreSQL for database" --type decision

# Search memories
contextfs memory search "database"

# Index your codebase for semantic search
contextfs index index
```

## MCP Integration

Add to your AI tool's MCP config:

```json
{
  "mcpServers": {
    "contextfs": {
      "command": "uvx",
      "args": ["contextfs"]
    }
  }
}
```

**Works with:** Claude Code, Claude Desktop, Cursor, VS Code, and any MCP-compatible client.

See [tool-specific setup guides](https://contextfs.ai/docs) for detailed instructions.

## Key Features

- **Semantic Search** - Find relevant memories using natural language
- **Auto Code Indexing** - Index your entire codebase for context-aware AI
- **Cross-Session Memory** - Decisions, facts, and patterns persist across conversations
- **Multi-Tool Sync** - Share memory between Claude, Cursor, VS Code, and more

## Python SDK

```python
from contextfs import ContextFS

ctx = ContextFS()

# Save
ctx.save("Use JWT for auth", type="decision", tags=["auth"])

# Search
results = ctx.search("authentication")
```

## Cloud Sync

Enable cross-device memory sync:

```bash
contextfs cloud login
contextfs cloud sync
```

Sign up at [contextfs.ai](https://contextfs.ai) for cloud features.

## Documentation

Visit **[contextfs.ai/docs](https://contextfs.ai/docs)** for:
- Installation guides for each AI tool
- API reference
- Memory types and best practices
- Cloud sync setup

## License

MIT - Matthew Long and The YonedaAI Collaboration
