Skip to content

GravionLabs/elysion / .agents/skills/context-statusline

context-statusline

Verified

/context-statusline: install a status line (model, context %, git branch, limits) for Claude Code or Copilot CLI, plus a Claude Code subagent line and a context warning hook. Use for "show context usage in the status line".

FileKindSize
SKILL.mdskill md4.1 KB
references/help.mdmarkdown2.4 KB
scripts/Install-Statusline.ps1script12.4 KB
scripts/context-warning.shexecutablescript7.0 KB
scripts/statusline.mjsscript3.8 KB
scripts/subagent-statusline.mjsscript1.9 KB

references/help.md

View on GitHub
# /context-statusline

## Usage

`/context-statusline [-Client claude|copilot|all] [-Force] [-Uninstall] [-NoContextWarning] [-WhatIf]`

Runs `pwsh scripts/Install-Statusline.ps1` with the given parameters. Without arguments it installs for Claude Code.

## Arguments and flags

- `-Client claude|copilot|all`: client to configure (default `claude`). Copilot CLI gets the status line and, unless `-NoContextWarning`, the `postToolUse` context warning hook.
- `-Force`: replace a `statusLine` / `subagentStatusLine` you set yourself.
- `-NoContextWarning`: do not register the context warning hook.
- `-Uninstall`: remove only the entries of this skill (status lines, hook, copies of older versions).
- `-WhatIf`: show what would change, write nothing.
- `help` (or `--help`, `-h`): print this text.

What you get:

- Status line (`statusline.mjs`): `user@host:dir`, model, `ctx:<pct>% (<used>k/<size>k)`, `(git branch)`, `5h:<pct>% 7d:<pct>%`. Null or missing fields are skipped.
- Subagent line (`subagent-statusline.mjs`, Claude Code only): one row per subagent with type, model, `ctx:<pct>%` and label.

- Context warning hook (`context-warning.sh`, bash): `UserPromptSubmit` on Claude Code, `postToolUse` on Copilot CLI. At `CONTEXT_WARN_TOKENS` (default 150000) the user sees a hint and the model is told to hand off and `/clear` (or `/compact`); the next warning needs `CONTEXT_WARN_STEP` (default 100000) more tokens. `CONTEXT_WARN_DEBUG=1` prints notes on stderr.

Requires Node >= 22 and PowerShell 7+. Both scripts run on every refresh: no network, always exit 0.

## Examples

- `/context-statusline -WhatIf`: preview the change for Claude Code.
- `/context-statusline`: install for Claude Code.
- `/context-statusline -Client all`: install for Claude Code and Copilot CLI.
- `/context-statusline -Force`: replace your own status line entries.
- `/context-statusline -Uninstall`: remove the entries again.

## Config

Settings (status lines and the hook) are written, not read from `.agents/config.json`: Claude Code `~/.claude/settings.json`; Copilot CLI `~/.copilot/settings.json` (or `$COPILOT_HOME/settings.json`). A `settings.json.bak-<timestamp>` is written first, other keys are kept. Restart the client to see the lines.

## See also

- `npx skills update` refreshes the scripts (the settings point at the installed skill, no copy).
- Docs: https://github.com/GravionLabs/skills/blob/main/docs/usage/statusline.md
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall