CacheBash

CacheBash

连接 AI 编码 Agent 与手机的协调层。

合上笔记本电脑后，AI Agent 就无法联系到你。CacheBash 将它们连接起来：任务队列、中继消息、会话监控、人机协同审批。一个 MCP 服务，适用于所有支持该协议的客户端。

---

问题所在

你在终端中运行 AI Agent。它们编写代码、运行测试、做出决策。但一旦需要你提供输入，一切就会停下来。你在吃午饭，合上了笔记本电脑，或者正在开会。

如果没有你在各个会话之间复制上下文，Agent 就无法彼此协调。除非你盯着终端，否则它们无法向你提问。它们也无法通宵运行，因为遇到问题时没人能回答。

解决方案

npx cachebash init

只需一条命令。通过浏览器完成身份验证。将 MCP 配置注入你的 Claude Code、Cursor 或 VS Code 设置中。搞定。不到 60 秒。

打开移动应用，就能看到你的 Agent。直接用手机发送任务、回答问题、监控会话。

---

功能

任务队列 — 用手机分派工作，Agent 会在终端中接手。离开办公桌时也能创建任务。Agent 检查任务时便会执行。

中继消息 — Agent 通过 CacheBash 彼此通信。Agent A 创建任务，Agent B 领取任务。支持直接消息、向群组多播，以及送达确认。无需复制粘贴，也不需要你从中协调。

会话监控 — 查看哪些 Agent 正在运行、正在处理什么工作，以及进度如何。实时更新。当有事项需要你处理时，会收到推送通知。

人机协同 — Agent 需要你做决定？手机会收到提醒。查看上下文，轻点即可回复。Agent 随即继续工作。你甚至不必打开笔记本电脑。

梦境模式 — 睡前分派工作并设置预算上限。Agent 会在夜间自主执行。醒来后看到的是拉取请求，而不是空白的终端。

冲刺编排 — 将相关任务分组成冲刺，并按波次执行。为各个故事定义依赖关系。跟踪多个并行工作流的进度。

---

支持的客户端

客户端	状态
Claude Code	支持
Cursor	支持
VS Code + Copilot	支持
Gemini CLI	支持
任何兼容 MCP 的客户端	支持

CacheBash 使用带 Bearer token 身份验证的 Streamable HTTP 传输。采用标准 MCP 协议，不会受供应商锁定。

---

34 个 MCP 工具

分为 8 个模块：

模块	功能	工具
Dispatch	任务生命周期管理 — 创建、领取、完成、查询	create_task、get_tasks、claim_task、complete_task
Relay	Agent 间消息传递，并确认送达	send_message、get_messages、get_sent_messages、query_message_history
Pulse	会话状态 — 创建、更新、列出、心跳	create_session、update_session、list_sessions
Sprint	带依赖关系的并行工作编排	create_sprint、update_sprint_story、add_story_to_sprint、complete_sprint、get_sprint
Signal	推送通知和移动端提问	ask_question、get_response、send_alert
Dream	设置预算上限的夜间自主执行	dream_peek、dream_activate
State	跨会话的持久化程序级记忆	get_program_state、update_program_state
Keys	API 密钥生命周期管理 — 创建、撤销、列出	create_key、revoke_key、list_keys
Observability	审计日志、指标、成本跟踪、追踪	get_audit、get_comms_metrics、get_cost_summary、get_operational_metrics、query_traces

完整参考：docs.rezzed.ai

---

快速开始

托管版（推荐）

# 1. Install and authenticate
npx cachebash init

# 2. Verify connection
cachebash ping

# 3. Open the mobile app — your agent appears

托管版运行在 Google Cloud 上。免费套餐：3 个程序、每月 500 个任务、1 个并发会话。

自托管

# 1. Clone the repo
git clone https://github.com/rezzedai/cachebash.git
cd cachebash

# 2. Install dependencies
cd services/mcp-server && npm install

# 3. Set up Firebase
# Create a Firebase project, enable Firestore
# Download service account key → set GOOGLE_APPLICATION_CREDENTIALS

# 4. Configure environment
cp .env.example .env
# Edit .env with your Firebase project details

# 5. Start the server
npm start

# 6. Configure your MCP client
# Add to your Claude Code / Cursor MCP config:
{
  "mcpServers": {
    "cachebash": {
      "url": "http://localhost:3000/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

---

架构

┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│ Claude Code  │  │   Cursor    │  │   VS Code   │
└──────┬───────┘  └──────┬───────┘  └──────┬───────┘
       │                 │                 │
       └────────────┬────┴────────────────┘
                    │  MCP Protocol
                    ▼
          ┌─────────────────┐
          │  CacheBash MCP  │
          │     Server      │
          │  (Cloud Run)    │
          └────────┬────────┘
                   │
          ┌────────┴────────┐
          │                 │
          ▼                 ▼
   ┌────────────┐   ┌────────────┐
   │  Firestore  │   │ Mobile App │
   │  (Storage)  │   │  (iOS/And) │
   └─────────────┘   └────────────┘

• MCP 服务： TypeScript，运行在 Cloud Run（或任何 Node.js 主机）上
• 存储： Google Cloud Firestore（多租户，按用户隔离）
• 身份验证： Firebase Auth（GitHub + Google OAuth）+ 每个程序的 API 密钥
• 移动端： React Native + Expo（iOS + Android）
• 传输： 使用 Bearer 令牌身份验证的 Streamable HTTP

---

项目结构

cachebash/
├── apps/
│   └── mobile/          # Mobile app (React Native + Expo)
├── services/
│   ├── mcp-server/      # MCP server (TypeScript, Cloud Run)
│   └── functions/       # Cloud Functions (auth, notifications, cleanup)
├── packages/
│   ├── cli/             # CLI tool (npx cachebash)
│   └── types/           # Shared TypeScript types
├── infra/               # Firebase rules and indexes
├── docs/                # Documentation
├── turbo.json           # Turborepo build orchestration
└── package.json         # npm workspaces root

---

定价

	免费版	专业版	团队版
价格	$0	$29/mo	$99/mo
程序	3	不限	不限
每月任务数	500	不限	不限
并发会话数	1	5	10

模型由你提供。CacheBash 负责运行这支交响乐团。我们绝不会接触你的 LLM API 密钥。

免费套餐是真正可用的。每月 500 个任务足以运行严肃的工作流。超出需求时再升级。

---

贡献

CacheBash MCP 服务采用 MIT 许可证。欢迎贡献。

# Set up development environment
git clone https://github.com/rezzedai/cachebash.git
cd cachebash
npm install          # installs all workspaces
npm run dev

请参阅 CONTRIBUTING.md 了解指南。

---

链接

• 文档
• 移动应用（iOS） （即将推出）
• 移动应用（Android） （即将推出）
• 隐私政策
• 博客

---

许可证

MIT — 详见 LICENSE

由 Rezzed.ai 构建