See where your tokens go and how many turns are left

Every turn costs more tokens than the last. crystl tracks the burn per shard, estimates the turns you have left, and shows what each plugin and skill costs, so you can trim before you hit the wall.

Agents run in a fixed context window that has to hold the system prompt, tool definitions, conversation history, and every file the model has read. As a session grows, each turn gets heavier, and eventually the model compacts its history or hits a hard ceiling. crystl watches every Stop hook and records how many tokens each turn actually burned.

As soon as an agent starts in a shard, a turns readout appears at the end of the line under the terminal. Once enough turns have landed to measure a burn rate, it switches to a ~N turns left estimate. Click it to open the context load panel: per-turn history, burn rate, model and window size, and an itemized breakdown of every plugin and skill loaded into the shard. Sort by cost, disable what you don't need for the current task, and the next turn's budget instantly stretches further.

Why it matters

Know every turn's cost

Each Stop hook records input and output tokens per turn, per shard. A long planning shard never pollutes the numbers for a fresh one next to it.

Turns left, not guesswork

After a few turns crystl projects how many more fit in the remaining window, computed from the shard's median burn rate. Read large files and the estimate drops to match.

See what each plugin costs

The panel itemizes every installed plugin and skill loaded into the shard, with the token weight of each one. The heavy entries are no longer hidden.

Reclaim budget in one click

Click a heavy plugin or skill and disable it for this gem or globally. Disable a Claude entry and crystl hot-reloads the running session: no restart, and your turns-left estimate ticks up immediately.

Re-scales when you switch models

crystl reads the model ID out of the transcript and looks up its window. Drop from Opus to Haiku mid-session and the estimate re-scales on the next turn.

Read the Context Load Tracking docs→

try it yourself

A free account and a download. macOS only, for now.

get startedgetting started guide →

Frequently asked questions

When does the turns-left estimate appear?
A plain turns label appears at the end of the line under the terminal as soon as an agent starts. It switches to the estimate once enough turns have landed to measure a burn rate. The rate is the median growth per turn, so one outlier turn can't produce a wild estimate.
How is the estimate calculated?
It's (window − used) ÷ burn rate, where burn rate is the shard's average tokens per turn so far. A shard reading large files burns faster and shows fewer turns left than one doing short exchanges.
What happens when I disable a plugin or skill?
For Claude, you can disable it for just this gem or for every gem and Claude session globally, and crystl injects /reload-plugins so the change takes effect mid-session. For Codex, disables land in ~/.codex/config.toml globally and you restart the codex process to apply them.
What does the panel track per turn?
Input tokens (prompt, history, tools, and file contents sent in) and output tokens (text, tool calls, and thinking generated). Each Stop hook appends a TurnMetric to the shard's session log; if the payload lacks token data, crystl falls back to parsing the transcript.
Does this work with Codex?
Yes, with fewer scopes. crystl scans ~/.codex/plugins/cache and ~/.agents/skills for Codex shards. Codex has no per-project plugin scope and no hot-reload, so disables are global and need a codex restart, where Claude disables can be gem-scoped and apply live.
Book of Spells
the crystl guild

Crystl's Book of Spells

Master crystl with a grimoire of powerful prompts. Summon heroes, assemble a party, revive shards, and complete epic quests.

open the book →

More features

Gems & Shards

Gems, shards, and the crystal rail keep every project one click away.

just-ask control

Ask for what you need and your agent does the clicking: text staged for copying, a button that runs the command, a task added, work booked for tomorrow.

Floating Cards

See what every agent needs from you, the moment it needs it.

Agent Activity Panel

One live view of every agent across all your gems: who's working, who's idle, and where tokens are going.

Schedule Agents

Launch a fresh agent at a set time (once, daily, or weekdays). Pick the gem, agent, model, and prompt; crystl fires it on schedule.

Automation (Sequences)

Automate the work you keep doing by hand. Write the job down once and let a schedule, a file landing, or a watched URL run it for you.

Parallel Sessions

Run several agents in the same project, each in its own git worktree.

Hero Shards

Summon a single hero as a shard (its own agent, model, and persona) without a quest party.

View Modes

Read a session as a terminal, as a conversation beside it, or as a conversation filling the window. The terminal keeps running either way.

History Navigator

Browse, jump through, and search every session: conversation and tool calls.

Accounts & Usage

Run Claude Code and Codex on more than one login, and see how much of each plan's limits you have used.

Workbench

A slide-out task list in every project, backed by a WORKBENCH.md the agent reads and writes with you.

Web Preview

A built-in browser column for local dev servers. Click what looks wrong, type a note, and your agent gets the element, a picture, and your words.

Markdown Editor

Read any .md rendered, with Mermaid diagrams drawn, and switch to the source to edit. Agents can open docs for you from the CLI.

Keys

Agents check which API keys they can reach and ask for a missing one on a masked card. Values go to your Keychain, never to the agent.

Prompt Integration

Facet Inserts give you one-click access to saved prompts, commands, and shortcuts.

Agent Files in Your Project Folder

Your agent setup as plain markdown committed with your code. Every agent reads the same files, every clone gets them, and nothing is locked inside crystl.

Agent File Editor

Create, edit, and manage CLAUDE.md, rules, skills, and agent config files with a block editor, file chooser, and project optimizer.

Project Optimizer

Scan your project for gaps in agent configuration (missing files, incomplete docs, oversized code, and setup issues) with one-click fixes.

Skills Library

Browse and import agentic skills that teach agents like Claude Code or Codex new tricks: code review, testing, deployment, and more.

cavrn terminal

The terminal as structured data: every turn, tool call, result, and table captured as agent-readable metadata. Drawn fast on the GPU with Metal.

Remote Development

Open or create a project on another machine over SSH. Approval cards, file relay, and click-to-open work there too.

Open Models

Run open models locally or hosted, orchestrate them with frontier agents, and cut token costs.

Agent Orchestration

One agent spawns, supervises, and merges the work of many: a control room for a team of agents.

crystl quest

Assemble a party of specialized agents. Each brings unique skills, coordinates in shared chat, and executes in parallel.

Screenshot Bar

Drag recent screenshots into the terminal. Spotlight-powered, always up to date.

Copy Bar

A one-click copy bar under the terminal. Agents stage text, you click Copy. Editable, up to 10 tabs, free.