ContextFS
Persistent Memory for AI Agents - Give your AI tools memory that persists across sessions.
Full Documentation | Get Started
Install
# With pip
pip install contextfs
# With uv (recommended)
uv pip install contextfs
# Run directly without installing
uvx contextfs
Quick Start
# 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:
{
"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 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
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:
contextfs cloud login
contextfs cloud sync
Sign up at contextfs.ai for cloud features.
Documentation
Visit 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
1 maintainer
Metadata
1 maintainer
Release files for contextfs 0.2.35
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| contextfs-0.2.35.tar.gz | 488.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| contextfs-0.2.35-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 850.8 kB
Release files / contextfs-0.2.35.tar.gz
| Download URL | contextfs-0.2.35.tar.gz |
|---|---|
| Size | 488.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ee667b07baec1ce639b9df5779eca5ec00e10bbcf34b8c84c958ca30ac8ab325
|
|
BLAKE2b-256 checksum How to use checksums |
8e1049b9c4b6454791fec3f864106435c8a824fbeea1afbd96f5c47375b8f27c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 29, 2026.
Transparency logRelease files / contextfs-0.2.35-py3-none-any.whl
| Download URL | contextfs-0.2.35-py3-none-any.whl |
|---|---|
| Size | 362.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d07d3b5014d0422d3405923dad067d15caacd88e8517668126a5c0cfe33bdb3b
|
|
BLAKE2b-256 checksum How to use checksums |
d38f60c6ed713a7c2977b5df445252b5af981e8b8fb9ccf7b29499f0a63a8ecc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 29, 2026.
Transparency log
