What does Caprock do?+
Caprock is a free desktop app for macOS, Windows and Linux that keeps the ledger of every coding agent you run — Claude Code, Codex, OpenCode, Gemini CLI and others, the sessions you start in your own terminal included: who is waiting on you, who is stuck, how close each plan is to its limit, and what each pull request cost, on your machine. Caprock records every session on the machine whether or not it started it, across Claude Code, Codex, OpenCode, Gemini CLI and others, prices each turn at list price when it is written, and joins it to the repository, pull request, CI run and release it produced. Run your agents in Caprock's terminal tabs and split panes, or keep your own terminal and your own phone: the ledger is the same either way. In the app each session has a terminal tab, with split panes, your projects and their worktrees in the sidebar and the sessions waiting on you first; a paired phone opens the same Caprock.
Is there a desktop app and a phone app?+
A desktop app, yes; the phone needs no app of its own. The desktop app runs on macOS (download it, or brew install --cask dspv/tap/caprock-app; signed with an Apple Developer ID and notarized by Apple), Windows and Linux, with the daemon — the background service that records your sessions — inside. It opens on your agent terminals and projects, and when a Claude Code session Caprock started asks for permission, the notification on macOS and Linux has Deny, and Approve when it shows the whole request. A phone pairs by QR code and opens Caprock in its browser, from anywhere, through an end-to-end encrypted relay: it reads a session as a chat and reconnects by itself, and once you allow control it answers prompts, clones a project and starts an agent in it.
Do I have to change how I work?+
No. Keep running claude in your own terminal. Caprock adds a small hook to ~/.claude/settings.json — backed up first, removed with caprock hooks uninstall — and reads the transcripts Claude Code already writes.
Will it see sessions from before I installed it?+
Yes. Caprock imports transcripts still on disk, which Claude Code keeps for 30 days by default. It then records new sessions and keeps them after Claude Code deletes the original files.
Does anything leave my machine?+
Only if you enable a network feature. By default, data stays in a SQLite file on your disk and Caprock listens on 127.0.0.1. There is no account or telemetry. You can enable update checks (the app asks once), connect GitHub to clone and open pull requests, send weekly reports and phone alerts to your Telegram bot, or ask Gemini using your API key. Updating downloads the new app from GitHub's release files. You can also pair a phone, which reaches Caprock from anywhere, through an end-to-end encrypted relay that sees only ciphertext. A phone you pair can control sessions unless you untick that when you pair it, and you can take control away in settings. A bug report or a survey answer reaches us only when you press Send. Pressing X, Threads or LinkedIn on the Week card uploads the picture you chose, alone, to caprock.dev so the post shows it; Settings → Privacy lists each one with Remove. The code is Apache-2.0 on GitHub.
How does it spot a stuck session?+
When a session calls the same tool with nearly the same input five times within three minutes, a banner goes up. Repeated reads and searches don't count: re-reading a file is normal work, and on 64,733 real tool calls they were over half of all alerts. Sessions Caprock started can be paused automatically.
Is it free?+
Yes, for solo use, and what is free stays free: live sessions, cost per repository, plan-limit warnings, history and search. A licence — $30 a year or $100 once — adds 8 features: Auto-pause at a daily budget, Pause at the plan limit, Answer from Telegram, A weekly report, Ask about your usage, Where each tool failed, Custom agents, More than three sign-ins per agent. The desktop app is free too. Caprock adds nothing to your Claude bill. The costs it shows are at API list prices: on a flat plan, an equivalent, not a charge.
How is it different from ccusage?+
ccusage prints usage tables in your terminal when you ask, with nothing running in between. Caprock runs in the background and keeps a ledger: live sessions, loop alerts, plan limits, cost per repository and per pull request, and history kept past Claude Code's 30-day cleanup. Use ccusage for a quick table, Caprock for every agent in one place.
What is the task runner?+
An opt-in way to run tasks unattended. You write a task and the commands that must pass, such as tests, type checks and lint. Each task runs in its own git worktree; Caprock runs your commands itself before marking the task done. It never merges into your branches. Workers skip permission prompts and your commands run with your permissions, unsandboxed — give it independent tasks you would run yourself.
