Claude Code · Statusline

M-STATUSLINE

The cockpit for the /m pipeline: git, phase, task flow, and pace-aware usage bars — one row per engine, Claude and Codex — in one Claude Code statusline.

The 5-hour and weekly bars project where you'll land at reset, not just what you've spent — a green-looking 60% on track to blow past 100% reads red now. While /m:develop runs, a cockpit line tracks the phase, its runtime, and the task flow from the .m/ state the pipeline writes.

Dwg No
MS-001
Rev
B
Date
2026-06-12
Scale
NTS
Runtime
Python 3 · stdlib
Deps
None
Usage rows
One per engine
Repo
GitHub
00

Fig. 0 · one pipeline run, replayed

drag the section line

A recorded 47-minute /m:develop run, played back through the statusline itself. Scrub the section line across the timeline: phases hand off, tasks complete, and the bars creep as the 5-hour pace climbs.

refine → plan → implement → review → iterate · plays itself when idle

01

The readout

the cockpit · stdin → stdout

Claude Code feeds the script a JSON blob on stdin; it writes the cockpit back. Git and ticket on top, the pipeline line while /m:develop runs, then one usage row per engine: Claude's pace-aware context and rate-limit bars, and — throughout a /m:develop run whenever it's enabled as the second engine — Codex's row with a live token-burn gauge.

02

Key · segments

what each block means
⎇ main ●3 ↑1
Git branch with uncommitted count, commits ahead/behind, worktree name when inside one.
ENG-142
Jira ticket captured from the branch via .m/jira.yml branchPattern.
m implement ◉◉○○ 2/5 ·12m
The pipeline cockpit, live while /m:develop runs: phase dots ( done · current · pending), phase runtime, tasks 4/6 progress, and the iterate loop counter. Hidden when the pipeline is idle.
Opus 4.8 · xhigh · CTX / 5H / WK
The Claude usage row, labeled with the active model. Context window plus both rate limits: used now → projected at window end, with the time to reset.
gpt-5.5 · xhigh · burn / idle
The Codex usage row — model and reasoning effort. While Codex drives plan and review: a live burn gauge (pass tokens vs token_budget); a dim · idle between passes. Hidden when Codex is disabled.
03

Colors

every field, one ladder
Load thresholds
SwatchLoad
███blue: under 50%
███green: 50–70%
███amber: 70–90%
███red: 90%+

Every bar fill colors itself up this ladder: the Claude rate-limit bars feed it their projection (so they warn while there's still time to slow down), while CTX and the Codex burn gauge feed the used value. The model-name label is brand-colored instead, not laddered — Claude orange, Codex white.

04

Install

no packages · stdlib only

Inside Claude Code, the setup command wires settings.json for you (existing settings preserved, backed up to settings.json.bak):

/plugin marketplace add milorad-teodorovic/m-statusline
/plugin install m-statusline@m-statusline
/m-statusline:setup
05

/m pipeline integration

one-way · optional

The ◉◐○ stage segment reads a .m/DEVELOP_ACTIVE marker and per-phase phase-<name>-done files, walking up from the working directory. The pipeline it tracks is refine → plan → implement → review → iterate. Don't use it? The segment simply never appears, and the rest of the statusline works unchanged.

Reference drawing The /m:* pipeline Open schematic →