promptvault (Aryamanpathak2022)

PromptVault

LLM提示的版本控制。Web仪表板+CLI+MCP服务器。

提示是代码——它们会进化、中断，需要回滚。但大多数团队在Notion文档或没有历史记录的分散文本文件中管理它们。PromptVault给出的提示与开发人员已经知道的版本控制工作流相同：init、commit、diff、branch、merge、push、pull。

](https://github.com/aryamanpathak2022/promptvault/stargazers)  

演示

观看现场演示 · 观看视频演练

为什么选择PromptVault？

“我们在谷歌文档中对提示进行了版本控制——这简直是一场噩梦。PromptVault为我们的提示工程带来了理智。” — *人工智能工程团队*

快速开始

一个命令安装（CLI）

# Install globally via npm
npm install -g promptvault

# Initialize your vault
pv init --author "Your Name" --email you@example.com

# Start tracking prompts
echo "You are a helpful coding assistant." > assistant.prompt
pv add assistant.prompt
pv commit -m "Add coding assistant prompt"

# View history
pv log

在本地运行（Web仪表板）

• Web仪表板 带有版本历史记录和差异查看器
• CLI工具 用于终端工作流（22个类似Git的命令）
• MCP服务器 用于克劳德代码/游标集成
• 公共提示共享 社区探索页面
• 出口、进口 用于备份和迁移（JSON、YAML、Markdown）
• 模板引擎 随着 {{variable}} 替换
• 快速脱绒 用于质量检查
• 分支与合并 具有三向合并和冲突检测功能
• API密钥验证 用于程序化访问

快速开始

一个命令安装（CLI）

# Install globally via npm
npm install -g promptvault

# Initialize your vault
pv init --author "Your Name" --email you@example.com

# Start tracking prompts
echo "You are a helpful coding assistant." > assistant.prompt
pv add assistant.prompt
pv commit -m "Add coding assistant prompt"

# View history
pv log

在本地运行（Web仪表板）

git clone https://github.com/aryamanpathak2022/promptvault.git
cd promptvault
npm install

# Configure environment
cp .env.example .env.local
# Edit .env.local — see "Environment Variables" below

# Set up database
npx prisma db push

# Start dev server
npm run dev

打开 http://localhost:3000 并登录GitHub。

CLI安装（源代码）

# Build the CLI
npm run build:cli

# Link globally
npm link

# Initialize a vault
pv init --author "Your Name" --email you@example.com

# Create and track a prompt
echo "You are a helpful coding assistant." > assistant.prompt
pv add assistant.prompt
pv commit -m "Add coding assistant prompt"

# View history and diffs
pv log
pv diff HEAD~1 HEAD

# Branch and merge
pv branch experiment
pv checkout experiment
# ... edit prompts ...
pv add assistant.prompt
pv commit -m "Try a more concise style"
pv checkout main
pv merge experiment

MCP服务器设置

首先构建CLI(npm run build:cli)，然后添加到编辑器配置中：

克劳德代码 (~/.claude.json 或项目 .mcp.json):

{
  "mcpServers": {
    "promptvault": {
      "command": "node",
      "args": ["/path/to/promptvault/dist/cli/mcp/server.js"]
    }
  }
}

光标 (.cursor/mcp.json):

{
  "mcpServers": {
    "promptvault": {
      "command": "node",
      "args": ["/path/to/promptvault/dist/cli/mcp/server.js"]
    }
  }
}

MCP服务器从本地读取 .pv/ vault位于您的工作目录中。跑 pv init 第一。

CLI命令参考

核心版本控制

及时管理

协作

MCP工具参考

提示也作为MCP资源通过以下方式公开 promptvault://prompts/.

API 参考

所有端点都支持会话身份验证（浏览器）或API密钥身份验证(X-API-Key 头球

从位于的仪表板生成API密钥 /dashboard/settings:

curl -H "X-API-Key: pv_your-key-here" https://your-instance.com/api/prompts

自我寄宿

环境变量

部署到Vercel

1. 推送到GitHub
2. 导入 维塞尔 --自动检测Next.js
3. 在项目设置中添加环境变量
4. 设置PostgreSQL数据库(霓虹 推荐）

部署到铁路

1. 将您的仓库连接到 铁路
2. 添加PostgreSQL插件（自动提供 DATABASE_URL)
3. 设置剩余环境变量
4. 部署

手册

npm install
npx prisma db push
npm run build
npm start

建筑

promptvault/
├── app/                  # Next.js App Router (web dashboard + API)
│   ├── api/              #   REST API endpoints
│   ├── dashboard/        #   Authenticated dashboard pages
│   ├── explore/          #   Public prompt discovery
│   └── p/[id]/           #   Public prompt viewer
├── cli/                  # CLI tool + MCP server
│   ├── commands/         #   22 Git-like commands
│   ├── mcp/              #   MCP server (stdio transport)
│   └── storage.ts        #   Local vault engine (.pv/ directory)
├── components/           # React components
├── lib/                  # Shared utilities (auth, prisma, formatting)
├── prisma/               # Database schema
└── tests/                # Vitest test suite (56 tests)

这 网络应用 通过Prisma在PostgreSQL中存储数据。这 命令行界面 管理本地 .pv/ 目录具有自己的提交图、分支和合并逻辑——不需要服务器。这 MCP服务器 将CLI存储引擎封装在模型上下文协议之上，以实现编辑器集成。CLI可以通过以下方式与web API同步 pv remote / pv push / pv pull.

技术栈

• 框架： Next.js 16（应用路由器、React 19、Turbopack）
• 语言： TypeScript（严格模式）
• 造型： 顺风CSS 4
• 数据库： PostgreSQL通过Prisma 7（Neon无服务器适配器）
• 认证： NextAuth.js v5（GitHub OAuth，JWT策略）
• CLI： 指挥官js，粉笔
• MCP： @模型上下文协议/sdk（stdio传输）
• 测试： 维测试
• CI/CD： GitHub 操作

贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feat/my-feature)
3. 进行更改并添加测试
4. 运行测试套件(npm test)
5. 用描述性消息提交
6. 打开拉取请求

许可证

麻省理工学院