vaultit

io.github.TheRealDataBoss由 GitHub 账号 TheRealDataBoss 发布v0.6.1更新于 Oct 24, 2026

Zero model drift between AI agents. Session continuity for Claude, GPT, Gemini, and any LLM.

概览

AI 生成的概览

vaultit 在多个 AI 代理之间共享项目上下文,通过 MCP 向助手提供会话、任务、决策与交接信息。

可以做什么
  • 跟踪代理会话,并在结束时写入摘要
  • 创建和列出项目任务与架构决策
  • 在会话与代理之间生成交接记录
  • 同步仓库状态、查看变更差异并导出项目上下文
  • 校验上下文文件并执行数据库结构迁移
适用场景
适合多个代理或大模型工具协作同一项目、希望保持会话、任务、决策与交接连续性的场景,避免每次重新说明背景。也适合需要为任意代理生成可直接粘贴简报的团队。
运行要求
需在本机用 pip 安装 Python 包,并以 stdio 进程运行(例如 python -m vaultit.mcp)。项目需先用 vaultit init 初始化;默认文件存储,也可选用 SQLite 或通过数据库 URL 使用 PostgreSQL。可选的 REST 服务需要 API 密钥。
安装前请注意
项目上下文、任务与决策会保存在本地或所配置的数据库中,写入内容会长期留存并可能被其他代理读取。REST 服务会签发 API 密钥并要求 Bearer 令牌,需妥善保管。PostgreSQL 后端需要含凭据的数据库 URL。写入上下文文件和执行结构迁移都会改动已存数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 vaultit,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

vaultit

mcp-name: io.github.TheRealDataBoss/vaultit

[PyPI] [Python 3.10+] [License: MIT] [MCP Native]

Zero model drift between AI agents.


Install

bash
pip install vaultit

Quickstart

bash
vaultit initvaultit sync --agent claudevaultit bootstrap --clipboard# paste into any AI — full context restored

CLI Reference

CommandDescription
initScaffold project context — state vector, conventions, tasks
syncScan repo and update state vector with current project state
bootstrapGenerate paste-ready briefing for any AI agent
statusShow tracked projects and their current state
doctorValidate context files for consistency and missing fields
migrateRun database schema migrations
exportExport project context to JSON/Markdown
diffShow what changed since last sync
serveStart the REST API server (FastAPI + Uvicorn)
sessionsList and manage agent sessions
tasksList and manage project tasks
decisionsList and manage architectural decisions
authCreate and revoke API keys (ck_ prefix, SHA-256 stored)

Python SDK

python
from vaultit import VaultItClient
client = VaultItClient()
# Sessionssession = client.create_session(agent="claude", project="myproject")client.end_session(session.id, summary="Implemented auth module")
# Tasks & decisionsclient.create_task(project="myproject", title="Add rate limiting")client.create_decision(project="myproject", title="Use PostgreSQL", rationale="Need JSONB")
# Handoffhandoff = 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:

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

Backends

bash
# File (default) — zero configvaultit init
# SQLitevaultit init --backend sqlite
# PostgreSQLvaultit init --backend postgres --db-url postgresql://user:pass@localhost/ck

REST API

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

bash
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

来源:packages/python/README.md,提交 b4b0a08

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.6.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分