Status Line Percentage Fields

New template variables for status line configuration:

Status Line Percentage Fields are template variables that display context window usage as numeric percentages rather than raw token counts.

What It Is

Claude Code 2.1.6 introduced context_window.used_percentage and context_window.remaining_percentage to the status line template system. These fields complement existing token-based fields like context_window.total_tokens by calculating and displaying context allocation as 0-100 values. Intended usage appears in statusLineTemplate configuration as {{context_window.used_percentage}}% used | {{context_window.remaining_percentage}}% free.

Runtime Status

The test (recorded 2026-01-16) explicitly marked this feature as NOT RUNTIME TESTED. The implementation was code-reviewed but never verified in live execution. Test author noted that runtime verification would require configuring a status line template with these fields and observing whether percentages rendered correctly during actual Claude Code use. This work was not completed.

Use Cases

The feature targets three patterns: (1) quick visual monitoring of context window fullness at a glance, (2) easier recognition of warning thresholds without mental arithmetic against model limits, and (3) simpler cognitive load than interpreting raw token counts. It makes context saturation more accessible to users unfamiliar with token economics.

Caveats

No observed runtime behavior exists. Percentage calculation logic, template rendering, accuracy relative to actual token consumption, and behavior at boundary conditions (0%, 100%, rounding) remain unverified in practice. The epistemic surface is code-level design only.

Evidence & receipt

file2.1.6/tests/02-status-line-percentages/TEST-RESULTS.md

◇ ed25519 receipt

idprimitive_ba95f6722a7d01056c316d52

alged25519

pubkey9b87705613b1e2fd064d57fa75a6b679d2856ceafad6b1daa8f982493871b6dd

sig

d61e48b1c2e2ba171de6cd5a1ef8631b4bfcc86932210aac1e8263ed46d84cf1db3c3e5f0ef625351111acf4f09e60f51676a278856690c78d29f4d55fb69804

Signed with an ed25519 key held off the repo. Anyone can verify against the published public key; nobody without the secret key can forge it. Click verify: it recomputes the signature in your browser. The signature proves integrity and authorship of this exact content — not a third-party timestamp or that the underlying claim is objectively true. signedAt is when the @f3/attest pipeline ran, not when the work happened; the evidence refs carry the source dates.

Connected

instance-of Skill Runtime Class
introduces (in) 2.1.6 Test (2.1.6) Release
verifies (in) Status Line Percentage Fields — runtime test Test

Status Line Percentage Fields

Primitive

Kind	Primitive
Introduced	Claude Code 2.1.6
Class	Skill Runtime
Epistemic	inconclusive · runtime-test
Evidence	1 ref
Receipt	ed25519 · verifiable

Hands-on runtime test · Claude Code 2.1.6

Cite this page

Hunter, R. "Status Line Percentage Fields." The Runtime Atlas. Content-addressed entity primitive_ba95f6722a7d01056c316d52, ed25519-signed (integrity, not third-party timestamp). https://ryanhunter.io/atlas/e/2-1-6-status-line-percentages

@misc{atlas-2-1-6-status-line-percentages,
  title  = {Status Line Percentage Fields},
  author = {Hunter, Ryan},
  note   = {The Runtime Atlas; entity primitive_ba95f6722a7d01056c316d52; ed25519-signed for integrity},
  url    = {https://ryanhunter.io/atlas/e/2-1-6-status-line-percentages}
}