What does Caprock do?+
Caprock is a free desktop app for macOS, Windows and Linux to run and watch several coding agents — Claude Code, Codex, OpenCode, Gemini CLI and others — in one window, with what each session costs. Each session gets a terminal tab, with split panes, your projects and their worktrees in the sidebar, and the sessions waiting on you first. The dashboard is inside it: what every session on the machine is doing — including the claude you start in your own terminal — what it has cost per repository, your plan limits, and when one is stuck. Your phone opens the same Caprock once paired.
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 the dashboard 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. 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: live sessions, loop alerts, cost per repository, and history kept past Claude Code's 30-day cleanup. Use ccusage for a quick table, Caprock to watch everything 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.