statusline-setup

A command for configuring the fleetline terminal information line and registering it in Claude Code's settings. It supports choices such as layout, character mode, background-agent tracking, fleet-view rows, and section order.

In plain words
What is it for?
Use it to choose a one-, two-, or three-line layout, enable or disable background-agent counts, and set the order of displayed status sections.
Why use it?
It turns fleetline's available display options into a saved setup suited to your terminal and workflow.

Command

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 commands/claudetool/fleetline/statusline-setup
Clone the repo
git clone --depth 1 https://github.com/ClaudeTool/fleetline
Per session 27 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,208 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.00027 $0.02208
Opus 5 $0.00014 $0.01104
Sonnet 5 $0.00005 $0.00442
Haiku 4.5 $0.00003 $0.00221

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

Security

Grade B, and why

statusline-setup 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.

- Home settings file: !`cat "$HOME/.claude/settings.json" 2>/dev/null || echo "(không tồn tại)"`
commands/statusline-setup.md · 94 lines

How it starts

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

Context

  • Home settings file: !cat "$HOME/.claude/settings.json" 2>/dev/null || echo "(không tồn tại)"
  • Existing config file (nếu đã setup trước đó): !cat "$HOME/.claude/statusline-fleetline.config.json" 2>/dev/null || echo "(chưa có)"

Your task

You are setting up the fleetline plugin for the user. Follow these steps in order. Do not skip the backup step under any circumstances.

  1. Ask with AskUserQuestion (one call, up to 4 questions):

    • Layout: "Minimal" (1 line), "Hardened" (2 lines, matches the classic layout — recommend this as default), or "Power-user" (3 lines, adds cost/session/PR/thinking/bg-agents/cache-TTL when present).
    • ASCII-safe mode: on/off. Recommend OFF unless the user says their terminal/font doesn't render Unicode or Nerd Font glyphs well.
    • Background-agent segment: on/off. Explain the real cost/benefit honestly: it calls claude agents --json to show how many background agents are running, but each call spawns a full CLI process (~0.4s observed) — throttled to once every N seconds (ask for N, default 60, minimum 5), not on every render. Recommend OFF as the default; only worth it if the user regularly runs multiple background/dispatched sessions.
    • If background-agent segment is ON: ask a follow-up whether to also enable the hook-based approximate counter (fills the gap between polls with a ~N estimate; requires restarting Claude Code for the new hooks to load per Claude Code's hook-loading model, and can drift high if an agent is killed abnormally — self-corrects at the next poll). Recommend OFF unless the user wants faster-updating estimates and is fine with the restart.
  2. Ask separately whether to also enable the fleet-view row renderer (subagentStatusLine — a DIFFERENT settings key from the main statusline, rendering rows in Claude Code's multi-agent/fleet view). Be upfront: this is the least-verified part of the plugin — it was built from documented field names but never tested against a real live multi-agent payload, only synthetic data matching the documented shape. Default recommendation: skip it unless the user specifically wants to try it and is fine with rough edges.

Read the full file on GitHub · 94 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 · 94 lines · 27 tokens per session scan B cc1153a6f907

Subscribe to this mod's changes

statusline-setup is a command published in the GitHub repository ClaudeTool/fleetline (4 stars, last pushed 6d ago), licensed MIT. It adds 27 tokens to every session and 2,208 once invoked, about $0.0001 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.