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.
55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# AgentHub statusline for Claude Code
|
|
|
|
`statusline/statusline.js` is a Claude Code [statusline](https://docs.claude.com/en/docs/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:
|
|
|
|
```bash
|
|
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 `statusLine` that 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 registers
|
|
`node "<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`.
|