About vaultit
vaultit is a project-context and session-continuity server for developers using multiple AI agents. It tracks project state, tasks, decisions, and sessions, then produces briefings that can be carried between agents.
Key features
- 01Project state tracking and synchronization
- 02Agent session and task management
- 03Context briefings for AI agents
- 04JSON and Markdown export
- 05File, SQLite, and PostgreSQL backends
- 06REST API and Python SDK
Use cases
- 01Carry project context between different AI agents
- 02Review project changes since the last sync
- 03Coordinate concurrent agent access
- 04Export project context for sharing
MCP support
vaultit provides an MCP server with 10 tools for native Claude Code integration.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEvaultit
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
| 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.