Skip to content
Turnscope

Know before you run out

A Mac menu bar app that shows what’s left of your coding agents’ usage limits, and whether they’ll last until they reset.

Download for Mac

Free and open source · macOS 26 · Apple silicon or Intel

A Mac at 7 AM. Asked to use subagents, Claude Code asks Turnscope whether 2 hours of work fit. About 1 hour 10 minutes of work is left before its 5-hour limit runs out, so it writes the tests itself. Turnscope’s panel, open from the menu bar, says Claude Max runs out in 1 hour and is back in 3, and shows each of its limits.
app — claude

>Use subagents to write the parser's tests.

●turnscope - check_limits (MCP)(hours: 2)

⎿2 more hours of work don't fit: 5 hours runs out after about 1h 10m of work.
Claude Max (me@example.com): about 1h 10m of work left (40m–2h 10m) before 5 hours runs out; it resets 10:00 (in 3h).
… +5 lines (ctrl+o to expand)

●That's about an hour of work, too little for subagents. I'll write the tests myself.

Claude Max runs out in 1h

Back in 3h.

5 hours · Runs out in 1h · Resets in 3h28%Weekly · Resets in 3h60%Opus weekly · Back Sat 9 AM0%Used most of 5 hoursFix the parserActive now32% · app

Used this week

Weekly · Reset 6:30 AM100%Monthly · Resets Oct 2297%As read yesterday 9 PM; no agent here is signed in to it now.Pi’s key$8.70 of $305 hours · Resets 11 AM100%Daily · Resets in 3h99%As read 6:50 AM; it couldn’t be read since.
Open OpenCode to sign in again.It couldn’t be read yet.

Try it: open an account.

Works with

  • Claude Code
  • Codex
  • OpenCode
  • Pi
  • Grok Build

Reads limits from

  • AnthropicClaude
  • OpenAIChatGPT
  • xAISuperGrok
  • OpenCode Go
  • OpenRouter

Plan around your limits

Turnscope reads your agents’ history on your Mac and asks each provider for your limits, with nothing to set up.

  • When it runs out

    Whether each limit lasts until it resets, or when it runs out at your pace.

  • Hours of work left

    How much agent work a limit has left, with an 80% range.

  • What used it

    Usage and cost by session, project, model or agent.

  • Notifications

    Before a limit runs out, when it’s used up, and when it’s back.

Your agents can check too

Turnscope is also an MCP server, so agents can check their limits before a big job. Its tools only read.

MCP docs

  • check_limits

    Whether planned work fits, and which account has room.

  • explain_usage

    What used a limit, or what it cost.

  • find_sessions

    Search past sessions by text, folder, agent or time.

  • handoff

    What another agent needs to finish a session.

  • read_session

    Read a session page by page, or just what failed.

  • continueprompt

    Start a new session from the last one’s handoff.

Connect in Settings → Agents, or run:

claude mcp add --scope user turnscope -- /Applications/Turnscope.app/Contents/Helpers/turnscope mcp

Hand off to another agent

When a limit runs out mid-task, another agent can pick up the work. Turnscope builds the handoff from the session files, without calling a model.

Use the handoff tool, the continue prompt or turnscope handoff.

app — codex

›Claude Code ran out. Pick up its work on the parser.

•Called turnscope.handoff({})

└# Handoff: Fix the parser

Claude Code session `claude-code:0f6e3f6a-713c-4d1e-9a6b-2b8c1d4e5f60` in `/work/app` on branch `main`, last active 08:01 (4m ago), 52 entries. Times are local; it's now Thu Oct 8 08:05.
… +71 lines

•Claude Code fixed nested tables and wrote two of the four test files. The third fails on inline tables, so I'll start there.

A status line and a guard

turnscope statusline puts your limits in your agent’s status line. turnscope guard lets a hook stop subagents when a limit runs low.

>
Claude Max · 5h 28%, out in 1h · weekly 60% · Opus weekly used up, back Sat 09:00

Add to settings.json:

{ "hooks": { "PreToolUse": [{ "matcher": "Agent", "hooks": [{ "type": "command", "command": "turnscope guard --limit week --below 10" }] }] }, "statusLine": { "type": "command", "command": "turnscope statusline" } }

The command line

It ships with the app. Add --json to any command that prints data.

CLI docs

  • turnscope status# every limit, forecast and hour of work left
  • turnscope status --hours 3# whether 3 more hours of work fit
  • turnscope usage --by model# the last 30 days by model
  • turnscope sessions --since today# today’s sessions
  • turnscope doctor# what can’t be read, and how to fix it

Your history stays on your Mac

Turnscope only reads. The one change it makes is adding its MCP server to an agent, when you ask.

  • No secrets kept

    Each login goes only to its own provider. API keys are kept as fingerprints.

  • No telemetry

    Besides your providers, it only talks to models.dev for prices and GitHub for updates.

  • No account

    Nothing to sign up for. What it knows stays in a local database.

Turnscope

Download for Mac

Free and open source · macOS 26 · Apple silicon or Intel

  1. Open the disk image and drag Turnscope to Applications.
  2. Open Turnscope. It lives in your menu bar and checks for updates on its own.
  3. Optional: add the command line to your PATH:
sudo mkdir -p /usr/local/bin sudo ln -sf /Applications/Turnscope.app/Contents/Helpers/turnscope /usr/local/bin/turnscope