# Caretbag

> Caretbag shows a Robinhood Chain wallet's holdings (official Robinhood stock tokens, Pons coins, ETH) in the Claude Code status line. Read-only: it only makes eth_call requests and never asks for keys or signs anything.

## Install
- `npx caretbag init 0xADDRESS` — installs the status line (keeps an existing one), adds a `/bag` slash command. Node 18+.
- `caretbag uninstall` — restores the original Claude Code settings.

## Commands
- `caretbag bag [--json]` — full table: amount, unit price, value, 24h change
- `caretbag refresh` — refresh now
- `caretbag add <CA>` / `caretbag remove <CA|SYMBOL>` — track a token the universe doesn't list
- `caretbag wallet add|remove|list` — more wallets
- `caretbag set maxPositions|color|ascii|layout <value>`
- `caretbag doctor` — diagnose the install

## Data
- `GET /universe.json` — every priced asset: `{ v, generatedAt, chainId: 4663, eth: {p, c}, nyse, token, assets: [{ a: address, s: symbol, n: name, d: decimals, k: "stock"|"pons"|"stable", p: priceUsd, c: change24hPct|null, mc? }] }`. No parameters about the user.
- `GET /api/stats` — public daily counters (universe downloads, web previews). No IPs, no addresses.
- Balances are read by the user's machine from `https://robinhood-rpc.publicnode.com` (Multicall3 0xcA11bde05977b3631167028862bE2a173976CA11). Caretbag's server never receives an address.

## Status line format
`^ bag <total> <24h> · <SYMBOL> <position value> <24h> · … · NYSE <pre|after|closed>`

## Token
- Until the token exists every feature is open. After launch: free = 1 wallet, top 3 positions; holder = many wallets, up to 12 positions, big-move marker. The check runs client-side in open-source code.
- No promise of returns. Not audited.

## Links
- Docs: /docs/
- Token: /token/
- Changelog: /changelog/