vaultit

mcp-name: io.github.TheRealDataBoss/vaultit

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

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

• GitHub
• Docs
• PyPI
• MCP Registry

License

MIT © TheRealDataBoss