nntrivi2001
f2f1cd9b6c
- Today's spend in the status bar and the Claude Code statusline is the
caller's own (`GET /api/pricing/cost?mine=1`, scope.ownSessionWhere), not
every user's sum for an admin or analyst.
- A screenshot pasted into a local claude pane is sent as Claude Code's own
image-paste key: Alt+V on Windows (Ctrl+V did nothing there), ^V elsewhere,
and only when the machine can read its clipboard (wl-paste/xclip + a
display on Linux), else it is uploaded (GET /api/run/native-paste {key}).
- A file manager's files pasted or dropped on a local browser go in by their
own paths, read from the OS clipboard or the file manager's selection
(server/lib/file-manager.js, POST /api/run/clipboard-files and
/selected-files): no upload, no size limit. A copied image file is pasted
by path, text that comes with a picture of it (spreadsheet cells) is
pasted as text, Windows paths go in as `C:/…` mentions.
- Tab titles for Snapshot, Artifacts, Files and Administration.
- An npm tool AgentHub installed under ~/.local is updated there, not by its
own updater into npm's global prefix.
2.7 KiB
AgentHub statusline for Claude Code
statusline/statusline.js is a Claude Code statusline
command. It prints one line under the prompt:
Opus 5.5 · main · ███░░░░░░░ 34% · $1.23 · today $45.68
| Part | Source |
|---|---|
| model | model.display_name from Claude Code's statusline JSON |
| branch | git symbolic-ref --short HEAD in the session's cwd (short sha when detached; 500 ms cap) |
| context bar | context_window.used_percentage, else current_usage (input + cache) ÷ context_window_size; green < 50 %, yellow < 80 %, red above |
$1.23 |
this session, Claude Code's own cost.total_cost_usd |
today $… |
your sessions today, from the dashboard: GET /api/pricing/cost?tz_offset=<local>&mine=1 → today's daily_costs row (in server mode only the pane's workspace owner's sessions, even for an admin; locally every session) |
Today's cost has a 1-second timeout and is cached for 30 s in
<os tmpdir>/agenthub-statusline-<uid>.json — a failed fetch is cached too, so a
stopped dashboard costs one timeout per 30 s, not one per prompt. When the
dashboard is down the part is simply left out. The script never throws, stops
itself after 2.5 s and always exits 0. The dashboard is found like the CLI finds
it (AGENTHUB_URL, then CLAUDE_DASHBOARD_PORT/DASHBOARD_PORT, then
~/.claude/.agenthub.json); DASHBOARD_TOKEN is sent when set.
Install / uninstall
Nothing is installed automatically. Run:
agenthub statusline install # adds statusLine to ~/.claude/settings.json
agenthub statusline install --force # also replaces a statusLine that is not AgentHub's
agenthub statusline uninstall # removes AgentHub's statusLine only
agenthub statusline uninstall --force # removes whatever statusLine is there
- The file is
$CLAUDE_HOME/settings.json(default~/.claude/settings.json); every other key is kept. - A
statusLinethat is not AgentHub's is refused (exit 1) unless--force. - Before any write the old file is copied beside itself as
settings.json.agenthub-backup-<timestamp>. - A plugin install registers
"~/.local/bin/agenthub" statusline(absolute path) — the launcher the bootstrap repoints at every update, because the plugin cache directory is replaced on update. A checkout registersnode "<checkout>/statusline/statusline.js".
agenthub statusline with no subcommand renders the line from stdin, which is
what the plugin-install registration runs.
Tests
server/__tests__/statusline.test.js: the formatter, today's cost against a fake
dashboard (cache, cached failure, timeout), the script end to end on stdin, and
install/uninstall against a temp HOME.