Skip to content

Context and usage

The context orb, compaction, run receipts, plan usage, the footer and the daemon menu in the desktop app.

This page covers the numbers that the desktop app shows about context, cost and plan limits, and the footer.

Context orb#

The composer's orb shows how full the context window is. Hover or click it for the breakdown: what fills it, the auto-compact line and the session's cost so far.

61.0k / 1.00M (6%)
System prompt3.24k<1%
Rules (AGENTS.md)~1.87k<1%
Skills~1.12k<1%
Conversation~40.2k4%
System tools (deferred)~4.38k<1%
Autocompact buffer200.0k20%
Free space939.0k94%
release-notes
Cached (read)56.8k
Cache write1.89k
Fresh input2.31k
Output1.24k
~ Estimated. This provider does not report exact counts.
CategoryIs
System promptThe agent's built-in instructions
Rules (AGENTS.md)Your AGENTS.md and CLAUDE.md files
Tool definitionsThe built-in tools' schemas
MCP tools, MCP instructionsWhat your MCP servers add
SkillsThe skills the agent can use, and the active ones
Searchable tools catalogThe list in the system prompt that names the tools the agent can find with tool_search and load on demand
ConversationMessages, tool calls and results so far
MCP tools (deferred), System tools (deferred)Tools that are listed but not loaded. They cost nothing until the agent uses them.
Autocompact bufferThe room past the auto-compact threshold
Free spaceWhat is left

Each category opens to its items and their sizes. The breakdown appears after the first run. Under the bar, the last turn splits into cached reads, cache writes, fresh input and output. ~ marks an estimate when the provider reports no exact counts.

Compaction#

Past the auto-compact line, the app summarizes the conversation and the session continues. What the model keeps: compaction.

WhereWhat
FooterA compacting indicator with its progress while the app writes a summary (with Settings › Interface › Streaming › Throbber on)
Palette, or Control Shift KCompact conversation, by hand
Session detailsCompact now
Settings › Agent › Context & limitsAuto-compact and its threshold. The compaction model is under Agent › Helper models

Run receipts and limits#

After each run, a transcript receipt gives the agent, model, time, cost and tokens. The agent badge has a swap icon when the run used a different agent than the previous one (Settings › Interface › Conversation › Run receipt). The orb's popover adds the session's total cost and run count. During a run, the run chip shows the numbers live.

Settings › Agent › Context & limits stops a run at a turn count, cost, token count or duration (run-level budgets).

Plan usage#

With Settings › Interface › Sidebar & usage › Check usage on, the app reads your signed-in providers' plan limits and credits, and GitHub's API limits (plan usage).

WhereShows
FooterThe most constrained window of the active provider, such as 5h 43%. It changes color at 60% and again at 85%. It shows only when a session is open and the provider reports usage. Settings › Interface › Sidebar & usage › Usage indicator.
Usage panelEvery provider's windows and credits, and GitHub's limits. Control P or a click on the footer gauge. Refresh reads them again.

Lifetime usage is on the welcome screen.

At the bottom of the sidebar, left to right:

ItemShows
Daemon dotThe daemon's state. Only with Shared daemon runtime on.
UpdateA new version, an install in progress, or a relaunch. See updates.
sign inShown while no provider has credentials. Opens Connect, the provider step of the setup wizard.
Usage gaugeSee plan usage
Compacting indicatorWhile the app writes a summary, with Throbber on
Space iconsIn the center, with spaces on. See spaces.
Settings gearOpens Settings (Command ,)

The daemon menu#

The daemon dot opens a menu with the connection, the daemon's sessions, then actions. It exists only with Settings › Advanced › Experimental › Shared daemon runtime on. What the daemon is: the daemon.

RowDoes
A session, Running or Waiting for your answerClick to jump to it. Its Stop button stops that run.
Stop all runsStops every run on the daemon
Relaunch ZidaneShown when the daemon runs newer code than the window
Reconnect nowRetries at once. Without it, the app retries every 5 seconds.
Restart daemonRestarts it once its runs finish
Restart daemon nowStops running work and restarts it
Turn daemon mode offRuns chats inside the window again
Copy diagnosticsCopies the connection details for a bug report

Reference#