# Cacheroo — Agent-First Cache Platform
# Version: {{VERSION}}
# https://cacheroo.com

> The ElastiCache alternative built for coding agents.
> One CLI to provision, cache, and manage your namespace.

## Quick Start
npm install -g cacheroo-cli
cacheroo signup myproject --local
cacheroo set key value --ttl 3600
cacheroo get key
cacheroo status

## CLI Reference
cacheroo signup <tenantId> [--local]    Provision namespace
cacheroo set <key> <value> [--ttl N]   Store value
cacheroo get <key>                      Retrieve value
cacheroo del <key>                      Delete key
cacheroo keys [pattern]                 List keys
cacheroo info [section]                 Cache INFO
cacheroo status                         Namespace usage
cacheroo verify                         Card verification
cacheroo init                           Agent setup wizard
cacheroo health                         Server health
cacheroo help                           All commands
cacheroo mcp-serve                      MCP server for Claude

## Agent Config Files
cacheroo init detects your agent and outputs the right config snippet:
- Claude Code: CLAUDE.md + .mcp.json
- Cursor: .cursorrules
- Cline: .clinerules
- Windsurf: .windsurfrules
- Aider: .aider.conf.yml

## Card Verification (one-time)
New signups must complete $1 Stripe card verification before full access.
Run: cacheroo verify

## Plans (source of truth: hub.tyga.cloud)
Pay-As-You-Go ($0 + usage): 1GB storage, 10K requests/day, 50 connections, Redis + Memcached APIs
Basic ($29.99/mo): 25GB, 100K requests/day, 500 connections, multi-region, auto-scaling, 14-day trial
Enterprise ($99.99/mo): Unlimited, dedicated nodes, VPC peering, 99.9% SLA, 30-day trial

## API Endpoints (advanced)
All requests require: Authorization: Bearer <API_KEY>
Key format: cr_payg_{tenantId}_{hex}

| Action | Method | Endpoint |
|--------|--------|----------|
| Sign up | POST | /api/signup |
| Plan limits | GET | /api/signup/limits |
| Verify card | GET | /api/billing/verify?tenant=X |
| Health | GET | /health |
| Support chat | WS | /ws/tai-chat?dept=dev |

## Documentation
- Quickstart: https://cacheroo.com/docs/quickstart.html
- Agent guides: https://cacheroo.com/docs/quickstart/claude-code.html
- This file: https://cacheroo.com/llms.txt