Statusline Claude Code statuslineLayout

AgentKit Statusline

The Claude Code status line installed by Engineer/Marketing kits — defaults, how to customize, and supported options.

Install

Where does it come from?

Kit export

Engineer / Marketing ship .config/statusline.cjs plus hook libs (render modes, section registry).

Claude Code registration

The adapter writes statusLine in Claude Code settings pointing at the installed script (project or global).

Defaults

What is the default today?

With no statuslineLayout in config, the renderer uses defaults identical to pre-refactor behavior.

Mode

full

baseMode / legacy statusline

Quota section

unless statuslineQuota: false

Colors

unless statuslineColors: false

responsiveBreakpoint

0.85

responsive wrap (0.5–1.0)

maxAgentRows

agent groups shown

todoTruncation

todo char truncate

Default line layout (dashboard builder)

lines[][]

[
  ["model", "context", "quota"],
  ["directory", "git", "cost", "changes"],
  ["agents", "todos"]
]

Note: cost defaults to enabled: false in DEFAULT_SECTIONS — it only shows when cost data exists and the section is enabled/included.

Sections

Supported section IDs

id	Default	Icon	Meaning
model	on	🤖	Active Claude model name
context	on	—	Context-window usage bar %
quota	on	⌛	Usage quota 5h / week (when cache eligible)
directory	on	📁	Workspace path (home → ~)
git	on	🌿	Branch + dirty/ahead/behind
plan	on	📋	Active plan label (if any)
cost	off	💰	Session API cost (when API billing)
changes	on	📝	Lines + / − this session
agents	on	🔄	Running / completed agent flow
todos	on	✅	Todo / task snapshot

agents and todos are multi-line sections (rendered separately, not as a single flat row).

Modes

baseMode / statusline mode

FULL

full (default)

Full configured lines: session rows + agents + todos per layout.

CMP

compact

Fewer lines — core info when the terminal is narrow.

MIN

minimal

Minimal — only the most important sections.

OFF

none

Disable statusline output (prints no status lines).

Customize

How do you customize?

1. Dashboard Statusline Builder (recommended)

Open ak config (Desktop or browser dashboard) → Statusline page. Drag sections, pick a theme preset, preview the terminal, Save. Config writes the statuslineLayout field in user config.

2. Edit config.yaml directly

Add a statuslineLayout object to ~/.agentkit/config.yaml (user). Project config can override via merge rules — secrets still stay out of project files.

Options

statuslineLayout — supported fields

Field	Default	Options / type	Meaning
baseMode	full	full \| compact \| minimal \| none	Primary render mode
lines	3 rows (builder default)	string[][] of section ids	Per-line section layout
sections	DEFAULT_SECTIONS	legacy array {id,enabled,order,…}	Legacy format (backward compat)
sectionConfig	{} / icons	per id: icon, label, color, maxWidth	Per-section display overrides
theme	Default theme	contextLow/Mid/High, accent, muted, separator, quotaLow/High	Context/quota/accent colors
responsiveBreakpoint	0.85	number 0.5–1.0	Wrap threshold vs terminal width (legacy layout)
maxAgentRows	4	number (≥0; 0 = hide agents)	Collapsed agent groups to show
todoTruncation	50	number	Todo text length cap

sectionConfig per id

icon — emoji/string prefix
label — optional label override
color — ANSI name: green, cyan, brightMagenta, dim, …
maxWidth — section width cap (number)

Theme presets (dashboard)

The builder ships presets: Default, Monochrome, Nord, Dracula, Catppuccin, Gruvbox, Tokyo Night, Solarized, Rose Pine, One Dark, Ayu — each sets theme + per-section colors.

Example

Sample statuslineLayout

config.yaml

# ~/.agentkit/config.yaml  (user scope — typical)
statuslineLayout:
  # full | compact | minimal | none
  baseMode: full
  lines:
    - [model, context, quota]
    - [directory, git, cost, changes]
    - [agents, todos]
  sectionConfig:
    model:
      icon: "🤖"
      color: cyan
    cost:
      # cost defaults to off in DEFAULT_SECTIONS; include it in lines to show
      icon: "💰"
      color: dim
  theme:
    contextLow: green
    contextMid: yellow
    contextHigh: red
    accent: cyan
    muted: dim
    separator: dim
    quotaLow: green
    quotaHigh: red
  # 0.5–1.0
  responsiveBreakpoint: 0.85
  maxAgentRows: 4
  todoTruncation: 50

# Optional legacy / related toggles (same config file):
# statusline: full           # fallback if baseMode missing
# statuslineQuota: false     # hide quota windows even if section on
# statuslineColors: false    # disable ANSI colors

Related toggles

Outside statuslineLayout

statusline

Legacy mode string (full/compact/…) if baseMode missing.

statuslineQuota

false = hide quota windows even if quota section is on.

statuslineColors

false = disable ANSI color output.