Skip to main content

Zero model drift between AI agents. Universal session continuity CLI and Python library for Claude, GPT, Gemini, and any LLM.

Project description

vaultit

PyPI Python 3.10+ License: MIT MCP Native

Zero model drift between AI agents.


Install

pip install vaultit

Quickstart

vaultit init
vaultit sync --agent claude
vaultit bootstrap --clipboard
# paste into any AI — full context restored

CLI Reference

Command Description
init Scaffold project context — state vector, conventions, tasks
sync Scan repo and update state vector with current project state
bootstrap Generate paste-ready briefing for any AI agent
status Show tracked projects and their current state
doctor Validate context files for consistency and missing fields
migrate Run database schema migrations
export Export project context to JSON/Markdown
diff Show what changed since last sync
serve Start the REST API server (FastAPI + Uvicorn)
sessions List and manage agent sessions
tasks List and manage project tasks
decisions List and manage architectural decisions
auth Create and revoke API keys (ck_ prefix, SHA-256 stored)

Python SDK

from vaultit import VaultItClient

client = VaultItClient()

# Sessions
session = client.create_session(agent="claude", project="myproject")
client.end_session(session.id, summary="Implemented auth module")

# Tasks & decisions
client.create_task(project="myproject", title="Add rate limiting")
client.create_decision(project="myproject", title="Use PostgreSQL", rationale="Need JSONB")

# Handoff
handoff = client.create_handoff(from_session=s1.id, to_agent="gpt-4")

MCP Server

10 tools — native Claude Code integration via Model Context Protocol.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "vaultit": {
      "command": "python",
      "args": ["-m", "vaultit.mcp"]
    }
  }
}

Backends

# File (default) — zero config
vaultit init

# SQLite
vaultit init --backend sqlite

# PostgreSQL
vaultit init --backend postgres --db-url postgresql://user:pass@localhost/ck

REST API

14 endpoints + 3 auth endpoints. FastAPI with OpenAPI spec.

vaultit serve --port 8420
# → http://localhost:8420/docs   (Swagger UI)
# → http://localhost:8420/openapi.json

Auth header: Authorization: Bearer ck_your_api_key

Multi-Agent Coordination

Three modes for concurrent agent access:

  • sequential — one agent at a time (default)
  • lock-based — pessimistic locking per resource
  • merge — optimistic merge with conflict resolution

Links

License

MIT © TheRealDataBoss

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

vaultit-0.6.0.tar.gz (51.8 kB view details)

Uploaded Source

Built Distribution

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

vaultit-0.6.0-py3-none-any.whl (49.7 kB view details)

Uploaded Python 3

File details

Details for the file vaultit-0.6.0.tar.gz.

File metadata

  • Download URL: vaultit-0.6.0.tar.gz
  • Upload date:
  • Size: 51.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for vaultit-0.6.0.tar.gz
Algorithm Hash digest
SHA256 4bc1d4e45d09fc2eb60b19cda1693dbccf47f56e542d95128c8934919244793c
MD5 8131ccada90f185528d03facd547f834
BLAKE2b-256 1234255ec9713c9d01643241346012fa71f8cf81ce97c91ee0163d4dfb022616

See more details on using hashes here.

File details

Details for the file vaultit-0.6.0-py3-none-any.whl.

File metadata

  • Download URL: vaultit-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 49.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for vaultit-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bc8e8b88a2674bd2eec352874a5f3661aff27603abcf7bcf386d780ccbcc9f34
MD5 194cd229ff91506211585e8b9ae52f96
BLAKE2b-256 277fd2b800df21db658f83d613656553a10a5b7e1d8203b476ed2cec3de3c3ae

See more details on using hashes here.

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