{
  "markdown": "# CacheBash\n\n[![CI](https://github.com/rezzedai/cachebash/actions/workflows/ci.yml/badge.svg)](https://github.com/rezzedai/cachebash/actions/workflows/ci.yml)\n\n**The coordination layer between your AI coding agents and your phone.**\n\nYour AI agents can't reach you when you close the laptop. CacheBash connects them. Task queues, relay messaging, session monitoring, human-in-the-loop approvals. One MCP server. Every client that speaks the protocol.\n\n---\n\n## The Problem\n\nYou're running AI agents in your terminal. They write code, run tests, make decisions. But the moment they need your input, everything stops. You're at lunch. You closed the laptop. You're in a meeting.\n\nYour agents can't coordinate with each other without you copying context between sessions. They can't ask you a question unless you're staring at the terminal. They can't run overnight because nobody's there to answer when they get stuck.\n\n## The Fix\n\n```bash\nnpx cachebash init\n```\n\nOne command. Authenticates via browser. Injects the MCP config into your Claude Code, Cursor, or VS Code setup. Done. Under 60 seconds.\n\nOpen the mobile app. Your agents appear. Send tasks, answer questions, monitor sessions — all from your phone.\n\n---\n\n## What It Does\n\n**Task Queues** — Dispatch work from your phone. Your agent picks it up in the terminal. Create tasks while you're away from your desk. Agents execute when they check in.\n\n**Relay Messaging** — Your agents talk to each other through CacheBash. Agent A creates a task. Agent B claims it. Direct messaging, multicast to groups, delivery confirmation. No copy-paste. No you in the middle.\n\n**Session Monitoring** — See which agents are running, what they're working on, how far along they are. Real-time updates. Push notifications when something needs your attention.\n\n**Human-in-the-Loop** — Agent needs a decision? Your phone buzzes. Read the context. Tap to respond. The agent continues. You never opened a laptop.\n\n**Dream Mode** — Dispatch work before bed. Set budget caps. Agents execute autonomously overnight. Wake up to pull requests, not a blank terminal.\n\n**Sprint Orchestration** — Group related tasks into sprints with wave-based execution. Define dependencies between stories. Track progress across parallel workstreams.\n\n---\n\n## Supported Clients\n\n| Client | Status |\n|--------|--------|\n| Claude Code | Supported |\n| Cursor | Supported |\n| VS Code + Copilot | Supported |\n| Gemini CLI | Supported |\n| Any MCP-compatible client | Supported |\n\nCacheBash uses Streamable HTTP transport with Bearer token auth. Standard MCP protocol. No vendor lock-in.\n\n---\n\n## 34 MCP Tools\n\nOrganized into 8 modules:\n\n| Module | What It Does | Tools |\n|--------|-------------|-------|\n| **Dispatch** | Task lifecycle — create, claim, complete, query | `create_task`, `get_tasks`, `claim_task`, `complete_task` |\n| **Relay** | Inter-agent messaging with delivery confirmation | `send_message`, `get_messages`, `get_sent_messages`, `query_message_history` |\n| **Pulse** | Session health — create, update, list, heartbeat | `create_session`, `update_session`, `list_sessions` |\n| **Sprint** | Parallel work orchestration with dependencies | `create_sprint`, `update_sprint_story`, `add_story_to_sprint`, `complete_sprint`, `get_sprint` |\n| **Signal** | Push notifications and mobile questions | `ask_question`, `get_response`, `send_alert` |\n| **Dream** | Autonomous overnight execution with budget caps | `dream_peek`, `dream_activate` |\n| **State** | Persistent per-program memory across sessions | `get_program_state`, `update_program_state` |\n| **Keys** | API key lifecycle — create, revoke, list | `create_key`, `revoke_key`, `list_keys` |\n| **Observability** | Audit logs, metrics, cost tracking, traces | `get_audit`, `get_comms_metrics`, `get_cost_summary`, `get_operational_metrics`, `query_traces` |\n\nFull reference: [docs.rezzed.ai](https://docs.rezzed.ai)\n\n---\n\n## Quick Start\n\n### Hosted (Recommended)\n\n```bash\n# 1. Install and authenticate\nnpx cachebash init\n\n# 2. Verify connection\ncachebash ping\n\n# 3. Open the mobile app — your agent appears\n```\n\nThe hosted version runs on Google Cloud. Free tier: 3 programs, 500 tasks/month, 1 concurrent session.\n\n### Self-Hosted\n\n```bash\n# 1. Clone the repo\ngit clone https://github.com/rezzedai/cachebash.git\ncd cachebash\n\n# 2. Install dependencies\ncd services/mcp-server && npm install\n\n# 3. Set up Firebase\n# Create a Firebase project, enable Firestore\n# Download service account key → set GOOGLE_APPLICATION_CREDENTIALS\n\n# 4. Configure environment\ncp .env.example .env\n# Edit .env with your Firebase project details\n\n# 5. Start the server\nnpm start\n\n# 6. Configure your MCP client\n# Add to your Claude Code / Cursor MCP config:\n{\n  \"mcpServers\": {\n    \"cachebash\": {\n      \"url\": \"http://localhost:3000/v1/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Architecture\n\n```\n┌─────────────┐  ┌─────────────┐  ┌─────────────┐\n│ Claude Code  │  │   Cursor    │  │   VS Code   │\n└──────┬───────┘  └──────┬───────┘  └──────┬───────┘\n       │                 │                 │\n       └────────────┬────┴────────────────┘\n                    │  MCP Protocol\n                    ▼\n          ┌─────────────────┐\n          │  CacheBash MCP  │\n          │     Server      │\n          │  (Cloud Run)    │\n          └────────┬────────┘\n                   │\n          ┌────────┴────────┐\n          │                 │\n          ▼                 ▼\n   ┌────────────┐   ┌────────────┐\n   │  Firestore  │   │ Mobile App │\n   │  (Storage)  │   │  (iOS/And) │\n   └─────────────┘   └────────────┘\n```\n\n- **MCP Server:** TypeScript, runs on Cloud Run (or any Node.js host)\n- **Storage:** Google Cloud Firestore (multi-tenant, per-user isolation)\n- **Auth:** Firebase Auth (GitHub + Google OAuth) + per-program API keys\n- **Mobile:** React Native + Expo (iOS + Android)\n- **Transport:** Streamable HTTP with Bearer token auth\n\n---\n\n## Project Structure\n\n```\ncachebash/\n├── apps/\n│   └── mobile/          # Mobile app (React Native + Expo)\n├── services/\n│   ├── mcp-server/      # MCP server (TypeScript, Cloud Run)\n│   └── functions/       # Cloud Functions (auth, notifications, cleanup)\n├── packages/\n│   ├── cli/             # CLI tool (npx cachebash)\n│   └── types/           # Shared TypeScript types\n├── infra/               # Firebase rules and indexes\n├── docs/                # Documentation\n├── turbo.json           # Turborepo build orchestration\n└── package.json         # npm workspaces root\n```\n\n---\n\n## Pricing\n\n| | Free | Pro | Team |\n|---|---|---|---|\n| Price | $0 | $29/mo | $99/mo |\n| Programs | 3 | Unlimited | Unlimited |\n| Tasks/month | 500 | Unlimited | Unlimited |\n| Concurrent sessions | 1 | 5 | 10 |\n\nYou bring the models. CacheBash runs the orchestra. We never touch your LLM API keys.\n\nFree tier is real. 500 tasks/month runs a serious workflow. Upgrade when you outgrow it.\n\n---\n\n## Contributing\n\nCacheBash MCP server is MIT licensed. Contributions welcome.\n\n```bash\n# Set up development environment\ngit clone https://github.com/rezzedai/cachebash.git\ncd cachebash\nnpm install          # installs all workspaces\nnpm run dev\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n---\n\n## Links\n\n- [Documentation](https://docs.rezzed.ai)\n- [Mobile App (iOS)](https://apps.apple.com/app/cachebash) *(coming soon)*\n- [Mobile App (Android)](https://play.google.com/store/apps/details?id=ai.rezzed.cachebash) *(coming soon)*\n- [Privacy Policy](https://rezzed.ai/privacy)\n- [Blog](https://rezzed.ai/blog)\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\nBuilt by [Rezzed.ai](https://rezzed.ai)\n",
  "bytes": 7639,
  "sha": "e7507d3aae59407ec3687569954b2aa55d77678873354ffb1f45d3830406a5bf",
  "repo_slug": "rezzedai/cachebash",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_feelgreatfoodie_cachebash_c396a0da/readme"
}