# 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

## Activation (7-day free trial)
Keyless signups get a 48h pre-activation window (capped: basic KV ops only).
Full access requires activating the 7-day free trial ($0 today, card on file).
Run: cacheroo verify

## Plans (source of truth: sdk.tyga.run — GET /api/signup/limits for live copy)
Basic ($29/mo): entry plan, 7-day free trial
Scale ($99/mo) / Business ($299/mo): higher limits
Enterprise: sales-gated

## Cache API
Base: https://cacheroo.com/api/v1/cache — Authorization: Bearer <API_KEY>
Namespace enforced server-side: cr:{tenantId}:

Key-value:
  POST /set {key, value, ttl?} · GET /get/:key · DELETE /del/:key
  POST /expire {key, ttl} · GET /keys?limit=100 · GET /info

Sorted sets (server-side ranking primitive — ranked storage for
leaderboards, ratings, trending; bounded reads, page cap 100):
  POST /zadd {set, member, score} · POST /zincrby {set, member, delta}
  GET /ztop/:set?limit&offset&withScores · GET /zrank/:set/:member?order=desc
  GET /zscore/:set/:member · GET /zrangebyscore/:set?min&max&limit
  GET /zcard/:set · DELETE /zrem/:set/:member · DELETE /zdel/:set
  POST /zexpire {set, ttl}
Note: "z:" KV key prefix is reserved for sorted sets.

## Other Endpoints
| Action | Method | Endpoint |
|--------|--------|----------|
| Sign up | POST | /api/signup |
| Plan limits | GET | /api/signup/limits |
| Activate trial | 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