desktop-statusline

Reviewed at commit f7ae347

Status band above the prompt in the Claude Desktop app's Code tab: folder, git branch and state, session age, prompt count and cost, a context meter, 5-hour…

Made by
George Liu
What we checked

Draws a status band above the prompt in the Claude desktop app: folder, git branch and changes, session age and cost, context and plan-limit meters, last-turn model and cache hit rate, subagents and workflow runs. It sends a notification at 80% and 95% of a usage limit. It runs read-only git commands in your project and makes no network calls.

Review details

Static review of the source at the pinned commit; not run. Registers session.start, session.attach (desktop), session.measure, turn.complete, turn.step (streaming, forwards chunks untouched and counts server-side tools), agent.spawn, tool.call for Agent (only schedules a refresh and passes the call on unchanged), session.compact and ui.render for AbovePrompt. Refreshes every 60 s and does nothing unless the desktop surface is attached. Runtime calls: $.session.usage, cwd, turns, surfaces, $.agent.list, $.clock, $.process.run of git status --porcelain=v2 --branch and git rev-parse --git-dir --git-common-dir in the session folder (fixed argv, 5 s timeout; like any git command it follows the repository's own git config), $.ui.notify and $.ui.toast for limit warnings, $.ui.resolve with an inline SVG meter built from numbers, and atoms for state kept in memory. One option, cache_ttl (1h or 5m). Never reads or writes files, contacts no host and does not read prompt or tool contents. This version adds server-tool counts, workflow run rows, cache-cold marking and an auto-compact-aware context meter. npm dependencies: none. The ../types import resolves to types/index.d.ts, which is included.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: no
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: no
  • Shows something on screen: yes
Hooked events
Screenshot of desktop-statusline

Status band above the prompt in the Claude Desktop app's Code tab: folder, git branch and state, session age, prompt count and cost, a context meter, 5-hour and weekly plan usage limit meters with reset countdowns, last-turn model, duration and cache hit rate, idle time against the prompt-cache TTL, compactions, and running agents. Toasts at 80% and 95% of a usage limit. Draws only on the desktop surface, so a CLI statusLine is left alone.

Made this mod? Add a badge to your README

modsforClaude badge for desktop-statusline

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/desktop-statusline.svg)](https://modsforclaude.com/mods/desktop-statusline/)

← All mods