statusline

Instructions for installing or updating a Claude Code terminal status bar. The bar can show session, Git, usage, cost, timing, telemetry, and active-agent information.

In plain words
What is it for?
Use it when setting up, changing, or updating the status bar and its bundled scripts, pricing data, telemetry, and personal display settings.
Why use it?
It puts development-session information in one place instead of requiring separate commands or tools.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/cdeust/session-optimizer/statusline
Any agent
npx skills add cdeust/session-optimizer --skill statusline
Clone the repo
git clone --depth 1 https://github.com/cdeust/session-optimizer

Made for: Claude Code, Codex.

Per session 67 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,202 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00067 $0.02202
Opus 5 $0.00034 $0.01101
Sonnet 5 $0.00013 $0.00440
Haiku 4.5 $0.00007 $0.00220

Measured 2d ago against content hash add99b829341, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

statusline scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

1. Locate the bundled `assets/` dir: `find ~/.claude/plugins -type d -path '*/statusline/*/assets' 2>/dev/null | head -1` (dev checkout of this repo: `plugins/statusline/assets/` directly).
plugins/statusline/skills/statusline/SKILL.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Statusline install

Installs the multi-line statusline that shows model + git context, a discrete heat-track context bar tied to per-model checkpoint thresholds, session cost and duration from one deduplicated ledger, 5h/7d rate-limit gauges with burn-rate pacing, per-session telemetry (tok/s, compactions, prompt-cache countdown), and live subagent activity — every line fitted to the terminal width.

The plugin bundles its assets under assets/:

File Role Update policy
statusline-command.sh Renderer entry point — the composition root, called by Claude Code every refresh overwrite on update (with backup)
statusline-lib/*.sh The renderer's modules, one concern per file (see below) overwrite the whole directory on update
costs.sh Cost ledger CLI — the single source of every dollar figure overwrite on update (with backup)
pricing.json Per-model token prices costs.sh prices with overwrite on update (with backup)
statusline-transcript.py Per-session telemetry, backgrounded on a 15 s TTL overwrite on update (with backup)
statusline-budget.json Personal config: display size, cache TTL copy only if absent — never overwrite
ctxguard-thresholds.json Per-model checkpoint thresholds, shared with the context-guard plugin copy only if absent — never overwrite

The renderer is a composition root plus a module directory. statusline-lib/ must be installed next to statusline-command.sh: the script resolves its modules relative to its own path, and exits with a message naming the missing file if any is absent ($STATUSLINE_LIB overrides the location).

Module Single responsibility
platform.sh BSD/GNU spelling differences (stat, date)
palette.sh Colour tokens, the heat-track bar
fit.sh Visible-width measurement and trimming
severity.sh The one ok/warn/danger scale and its thresholds
format.sh Numbers and times as the reader sees them
config.sh The two JSON config files
gitctx.sh The repository facts
session_state.sh Cost ledger, transcript telemetry, subagent tracker
layout.sh Terminal width probe, verbosity preset
render.sh One function per status line

A SessionStart hook (hooks/hooks.json) injects a short maintenance instruction each session start so Claude reconciles the CODE assets into ~/.claude when the plugin updates — the two config files are never touched automatically.

Superseded: statusline-costs.py was removed in 2.1.0. It summed every assistant line of every transcript and over-counted spend ~2.2x, because Claude Code re-logs one API response 2-3 times (streaming / tool continuation). costs.sh deduplicates on message.id:requestId before pricing. An install that still has ~/.claude/statusline-costs.py should delete it — nothing reads it any more.

Read the full file on GitHub · 158 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 158 lines · 67 tokens per session scan B add99b829341

Subscribe to this mod's changes

statusline is a skill published in the GitHub repository cdeust/session-optimizer (1 stars, last pushed 8d ago), licensed MIT. It adds 67 tokens to every session and 2,202 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

civitai-mcp-ultimate

Ultimate MCP server for Civitai — search models, browse top images with prompts, download LoRAs/Checkpoints, analyze trends. Use when user asks about AI models, LoRAs, checkpoints, Stable Diffusion, Flux, image generation prompts, or Civitai.

timoncool/civitai-mcp-ultimate · 65 tokens

container-manager-podman-operations

Rootless Podman pod/kube operations via the container-manager-mcp MCP server — pods (create/list/stats/top/inspect/logs/stop/rm), Kubernetes YAML interop (generate/play kube), checkpoint/restore, pod-scoped networks and volumes, health checks, and system prune. Use when the agent must drive Podman pod-level workloads…

Knuckles-Team/container-manager-mcp · 114 tokens

Training

Guides fine-tuning and post-training work with explicit data, objective, hardware, and rollback assumptions.

agentic-in/elephant-agent · 23 tokens

agent-rollback

Use the agent-rollback MCP server or ar CLI to snapshot the workspace, list/show/diff checkpoints, and roll back unwanted changes. Use this skill whenever the user mentions checkpoints, rollback, undo, revert, restore, "go back to", "what changed", "I broke something", "this isn't working", or asks to inspect or…

Nainish-Rai/agent-rollback · 139 tokens

context-bridge

Cross-session task memory and stagnation detection for Claude Code, backed by a local context-bridge server that auto-starts on session start. Use when hook output tagged [context-bridge] appears, when the user says "checkpoint", "sync context", or "remember this for next session", when a task keeps reappearing…

pushkalkumar/context-bridge · 89 tokens

repo-checkpoint

Cross-agent repo-local progress checkpoint workflow for any git repository. Use this skill whenever the user says save progress, checkpoint, snapshot the current lane, capture key chat context, write down what matters before closing, or wants the next session to resume immediately from Codex, Claude Code, opencode, or…

hotalexnet/agent-checkpoint · 68 tokens