cctopOperator's manual

cctop / Panel guide / Turn

§4TurnNoteHook and permission timings become exact after cctop install.

Turn

What the current turn is actually waiting on — the model, a tool, a hook, a permission prompt, or nothing at all.

Turn duration

reads as
elapsed 2:31
What it means
The wall-clock time actually experienced — what you waited for this turn.
What to do
Split it against model time, hook time and permission wait below to see where the time really went.
Measured
ms · from the transcript · exact · how

API calls

reads as
api 3 calls
What it means
How many round-trips to the model happened inside one turn — each one re-sends the entire context.
What to do
A turn with many calls often means many small tool round-trips; fewer, larger tool calls usually cost less.
Measured
count · from the transcript · exact · how

API time

reads as
api / tools ≈0:02 / 0:46
What it means
Time actually spent waiting on the model to respond — the baseline the other overheads are measured against.
What to do
Not directly actionable; it's the number everything else in this panel is subtracted from.
Measured
ms · from Claude Code's own cost record · the transcript · exact for the session, ≈ per turn · how

Retry time

What it means
Time spent on requests that had to be retried — pure waste, since no new work happened during it.
What to do
Persistent retries point at a network or rate-limit issue outside a single session's control, but this confirms it wasn't something you did.
Measured
ms · from Claude Code's own cost record · exact · how

Phase

What it means
The last call's phase over the last seven calls (phase.rs: EXPLORING / IMPLEMENTING / VERIFYING / COMMITTING / PLANNING / DELEGATING / BROWSING / OPS / WAITING) and its run length; WAITING when a permission dialog, an AskUserQuestion or a Notification is pending
Measured
enum · from the transcript · hook events (after cctop install) · exact · how

Last check

What it means
The newest test-class Bash call whose output confirmed a run (test result:, N passed, # pass…), its verdict and age; edits since counts Edit/Write calls after it
Measured
enum · from the transcript · exact · how

Waiting on you

What it means
A pending permission dialog (hook), a running AskUserQuestion / ExitPlanMode, an idle_prompt / agent_needs_input notification, or a finished turn whose last text ended with ?; with the wait's duration
Measured
enum · from the transcript · hook events (after cctop install) · exact · how

Steers

What it means
Human queued_command attachments folded into the turn (absorbed mid-turn); task notifications are machine turns, not steers
Measured
count · from the transcript · exact · how

Interrupts

What it means
[Request interrupted by user…] lines with interruptedMessageId, and the output tokens the cut turns had produced
Measured
count · from the transcript · exact · how

Hook time by command

What it means
stop_hook_summary.hookInfos[].command and hook_success attachments summed per command over the session; preventedContinuation marks a blocked stop
Measured
ms · from the transcript · exact · how

Goal

What it means
The last goal_status attachment (/goal): met, iterations, tokens
Measured
enum · from the transcript · exact · how

Hook runs

reads as
hooks 6 runs
What it means
How many hooks fired during the turn — each one runs synchronously and adds to what you wait for.
What to do
A turn with unexpectedly many hook runs is worth checking against your hook matchers.
Advisor
A16 Hook overhead
Measured
count · from the transcript · exact · how

Hook time

reads as
hooks 6 runs · 84 ms
What it means
The total time hooks added to this turn, on top of the model's own response time.
What to do
A slow hook after tool calls or at the end of a turn should run asynchronously, or match only the tools and paths it actually cares about.
Advisor
A16 Hook overhead
Measured
ms · from the transcript · hook events (after cctop install) · exact · how

Permission wait

reads as
permission waits 1 · 12 s
What it means
Time the model sat completely idle waiting on a permission decision from you.
What to do
A tool pattern approved the same way repeatedly is a candidate for the allow-list in your settings, which removes the prompt entirely.
Advisor
A09 Permission waits · A45 Denial streak
Measured
ms · from hook events (after cctop install) · always an estimate · how

Queued prompts

reads as
queued 0
What it means
Prompts you typed while the model was still working on the previous one.
What to do
Informational — a growing queue late in a task can mean it's time to interrupt instead of keep queuing.
Measured
count · from the transcript · exact · how