Skip to main content

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.

PyPI CI Coverage License: MIT Python 3.10+

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

contextfs-0.2.32.tar.gz (477.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

contextfs-0.2.32-py3-none-any.whl (359.8 kB view details)

Uploaded Python 3

File details

Details for the file contextfs-0.2.32.tar.gz.

File metadata

  • Download URL: contextfs-0.2.32.tar.gz
  • Upload date:
  • Size: 477.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for contextfs-0.2.32.tar.gz
Algorithm Hash digest
SHA256 f4f4ab7ec08d02e92d82b4d1a24eca4633a8195733c8a8e616af80a3da3b4624
MD5 f02d67009ea219544576ef599c3f40a9
BLAKE2b-256 7d8db030ba57c901677d61c9eacf909829e4ee4e082614418e62568c03ce2f1f

See more details on using hashes here.

Provenance

The following attestation bundles were made for contextfs-0.2.32.tar.gz:

Publisher: release.yml on contextfs/contextfs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file contextfs-0.2.32-py3-none-any.whl.

File metadata

  • Download URL: contextfs-0.2.32-py3-none-any.whl
  • Upload date:
  • Size: 359.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for contextfs-0.2.32-py3-none-any.whl
Algorithm Hash digest
SHA256 9b157ede6b1fb788dc5c1d8f507bae4afa0c047180bb91ad0c9c55551a5838d0
MD5 f2bdd2a9c8358d67ffd37acba1b93520
BLAKE2b-256 3f2569eecab37f659d37f06ab4e5a5b68d8d68d8e69ea2f80ebac4c9d956fd33

See more details on using hashes here.

Provenance

The following attestation bundles were made for contextfs-0.2.32-py3-none-any.whl:

Publisher: release.yml on contextfs/contextfs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page