npx cachebash init

# 1. Install and authenticate
npx cachebash init

# 2. Verify connection
cachebash ping

# 3. Open the mobile app — your agent appears

# 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) │
   └─────────────┘   └────────────┘

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

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