Universal AI memory layer - cross-client, cross-repo context management with RAG
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file contextfs-0.2.23.tar.gz.
File metadata
- Download URL: contextfs-0.2.23.tar.gz
- Upload date:
- Size: 456.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f3c8c6cc83d987e8329dc0043ef6ea13447490b851ebbec85cbdb5a4b972591a
|
|
| MD5 |
3909a6e5119fa77dcdcf02ba61faf183
|
|
| BLAKE2b-256 |
ff46ed30c9010a1910614cdf3bf7d7408ef46adb95e73c46b5410da89363297e
|
Provenance
The following attestation bundles were made for contextfs-0.2.23.tar.gz:
Publisher:
release.yml on contextfs/contextfs
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
contextfs-0.2.23.tar.gz -
Subject digest:
f3c8c6cc83d987e8329dc0043ef6ea13447490b851ebbec85cbdb5a4b972591a - Sigstore transparency entry: 832658936
- Sigstore integration time:
-
Permalink:
contextfs/contextfs@ed984dff0e8f3492076b8253e78136a7ff6bace4 -
Branch / Tag:
refs/tags/v0.2.23 - Owner: https://github.com/contextfs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@ed984dff0e8f3492076b8253e78136a7ff6bace4 -
Trigger Event:
push
-
Statement type:
File details
Details for the file contextfs-0.2.23-py3-none-any.whl.
File metadata
- Download URL: contextfs-0.2.23-py3-none-any.whl
- Upload date:
- Size: 356.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a748fb42d58275ad77133811bcb236adfbaa9032b20c25795b77533f9fbebdf
|
|
| MD5 |
45831bb30083ae2731616176030fc627
|
|
| BLAKE2b-256 |
68636694376cc73090be7632dabe18bb1ebab3e97a8f9391aac3d99254bc28d5
|
Provenance
The following attestation bundles were made for contextfs-0.2.23-py3-none-any.whl:
Publisher:
release.yml on contextfs/contextfs
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
contextfs-0.2.23-py3-none-any.whl -
Subject digest:
3a748fb42d58275ad77133811bcb236adfbaa9032b20c25795b77533f9fbebdf - Sigstore transparency entry: 832658938
- Sigstore integration time:
-
Permalink:
contextfs/contextfs@ed984dff0e8f3492076b8253e78136a7ff6bace4 -
Branch / Tag:
refs/tags/v0.2.23 - Owner: https://github.com/contextfs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@ed984dff0e8f3492076b8253e78136a7ff6bace4 -
Trigger Event:
push
-
Statement type: