What is a Claude Code statusline?

It is the status line shown at the bottom of a Claude Code CLI session, typically showing the current directory, active model, remaining context window percentage, and other operational details, generated by a bash script the user configures.

Do I need the full Aki Dev Sync app to use just the statusline script?

No. The statusline script ships standalone at share/aki-statusLine/statusline.sh in the repo. Copy it to ~/.claude/statusline-command.sh and reference it in ~/.claude/settings.json, no app install required.

Can I push the statusline config to a remote server too?

Yes. The Statusline Customizer supports applying a configuration to the local machine and/or any number of configured SSH remote hosts at once, so one edit updates it everywhere.

Statusline Customizer in Aki Dev Sync: Build a Claude Code Status Line

Q: What does the 5-tier color ladder mean?

It is 5 color tiers by urgency of a percentage value: blue below 25%, green 25-55%, yellow 55-75%, orange 75-88%, red at 88% and above, with bands narrowing as urgency increases.

What Is the Statusline Customizer?

In Aki Dev Sync 1.35.0, monitoring has expanded from a single statusline into dashboards for Claude Code and Antigravity. Choose a 2/4/6/8-slot layout, control each monitor independently, and see parallel refreshes with a countdown to the next update; several Claude Code accounts on one machine each keep their own numbers. The history below still documents how the Statusline Customizer and standalone script evolved.

The Statusline Customizer is a tool inside Aki Dev Sync that visually builds the ~/.claude/statusline-command.sh file for the Claude Code CLI, the status line shown at the bottom of every terminal session. Instead of hand-editing bash and jq, you toggle fields on and off, drag to reorder them, and pick colors from swatches, with everything reflected in a live preview.

The Statusline Customizer interface with a drag-and-drop field list, color swatches, and a live preview line at the top

The Statusline Customizer modal: field list, drag handles, color swatches, and a live preview line.

Which Fields Can Be Toggled?

Identity (user@host): username and hostname, each independently colorable.
Current working directory.
Model and effort level: effort is split into its own toggle, locked to grey, so the model name can stand alone when effort isn't needed.
Context window percentage, with input/output tokens and the /max value.
5-hour and 7-day rate limits, each window with its own sub-row showing the estimated time to reset.
Session duration, lines changed, and session cost.
Cache hit/read percentage.
Current git branch.

Drag-and-Drop Reordering and Field Groups

Fields are reordered using native HTML5 drag-and-drop, with no extra dependency. Related fields are grouped: model+effort, 5-hour+7-day rate limits, cache%+tokens. A group moves as one unit, and individual members cannot be dragged out of their group.

In the actual generated statusline, fields within the same group render joined together with no | separator between them; the | character only appears between different blocks, keeping the line readable instead of fragmented into tiny pieces.

How Does the 5-Tier Dynamic Color Ladder Work?

Dynamic color splits into 5 tiers by urgency: blue below 25%, green 25-55%, yellow 55-75%, orange 75-88%, red at 88% and above. The bands narrow as urgency rises, since that's exactly where color needs to carry the most information.

In the UI, this shows as a proportional colored bar, with threshold inputs positioned directly under their own band, meaning the input's position is its meaning, no extra label text required to understand it. Session cost is colored by the same ladder, scaled against $30 as the full-red ceiling.

Color Swatches Instead of Text Dropdowns

Each field used to pick its color from a text <select> dropdown, which took up a fair amount of horizontal width. Now each field has a small 14x14px color block; clicking it opens an 8-swatch palette for a quick pick, same information.

Applies to Multiple Machines at Once

A statusline configuration applies to the local machine and/or any number of configured SSH remote hosts at once (multi-host push). Edit once, update the statusline everywhere, no need to log into each machine separately to adjust it.

The Default Color Doctrine

The default palette follows a clear doctrine: white for labels and punctuation, cyan for ordinary information, yellow/magenta to mark "which machine am I on" (a standout the eye can find quickly across multiple open terminals), grey for secondary detail, and dynamic color for anything that must be noticed immediately.

Use the Script Standalone, No App Install Needed

The core of this feature, the script that generates the statusline, also ships standalone at share/aki-statusLine/statusline.sh in the repo, no need to install the full Aki Dev Sync app to use it. Just copy the file to ~/.claude/statusline-command.sh, add a statusLine entry in ~/.claude/settings.json, and have jq installed on your machine.

Regression-Tested

The script generator is regression-tested with three layers: a bash -n syntax check on the full script, join-expression assertions for each field group, and an end-to-end run against a realistic Claude Code payload. That means an edit to the script generator can't silently produce broken bash.

What's New in v1.26.0: Claude Code and Antigravity CLI Unified

Before v1.26.0, the Statusline Customizer had a quiet gap: its own tooltip claimed the file would be written for both Claude Code and the Antigravity CLI (AGY), but the checkboxes actually defaulted to AGY-only, so plenty of users assumed ~/.claude/statusline-command.sh had been written when it never was. v1.26.0 fixes this at the root: both the Claude Code and AGY targets are now ticked by default, and the tooltip lists the exact file paths that will be overwritten before you confirm.

The second big change is in how the script itself is generated. Previously, Claude Code and the Antigravity CLI each received a separately generated script, and these two "dialects" could drift apart over time if one got patched and the other didn't. As of v1.26.0, both CLIs share one byte-identical script, which self-detects which CLI is running it and behaves accordingly, eliminating the drift risk entirely.

Finally, this release also fixes a bug that had persisted since v1.10.0: a "phantom quota" issue where a stale reading, left over from a different account's session, could get stuck on the statusline indefinitely and never refresh, showing incorrect numbers until the app was restarted. That bug is now fully resolved.

What's New in v1.34.0: One Set of Numbers Per Claude Code Account

Claude Code keys each login by the CLAUDE_CONFIG_DIR string (Keychain item Claude Code-credentials-<sha256[:8]>), so one config directory can hold two accounts, and the single shared quota file used to take whichever account ran the last turn. The statusline hook (aki-rlcache v6) now resolves each session's account per login slot and keeps one quota file per account under ~/.claude/rate-limits/. The usage card in the app gets the same account menu Antigravity has: click the email to pick one, and the choice is pinned per slot and per agent.

A statusline hook written by an older version of the app is now rewritten on its own when the app launches, on this Mac and on every project's SSH host. Your saved Customizer settings are kept, a timestamped backup is written, and a host where the write fails gets a warning toast. A statusline without the aki-rlcache marker is not the app's and is left alone. Before, the app only checked that a hook existed, so an upgraded app kept reading the old single file and showed one account.

What's New in v1.35.0: AGY Statusline Counts Argon 4 Quota Correctly

Antigravity added a separate weekly quota pool for its Argon 4 models. The shared statusline script now routes AGY quota across three pools: Argon models count against the Argon 4 pool (which has no 5-hour window, so the statusline leaves that window out), and every other model still counts against the Gemini or Claude/GPT pool. A host still on an AGY script older than Argon support shows a hollow AGY tag with an "older version - press Apply" hint in the Customizer, instead of silently reading Argon from the Gemini pool. The AGY script is still never rewritten automatically. After Apply, the written hosts' tags update at once, and the success message names the CLIs that were actually written.