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".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.1 KB |
| references/help.md | markdown | 2.4 KB |
| scripts/Install-Statusline.ps1 | script | 12.4 KB |
| scripts/context-warning.shexecutable | script | 7.0 KB |
| scripts/statusline.mjs | script | 3.8 KB |
| scripts/subagent-statusline.mjs | script | 1.9 KB |
SKILL.md
View on GitHub---
name: context-statusline
description: '/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".'
disable-model-invocation: true
metadata:
opencode/autoinvoke: 'false'
---
# context-statusline
`help` (or `--help`, `-h`): print `references/help.md` unchanged, nothing else.
Claude Code (status line and subagent line) and GitHub Copilot CLI (status line and context warning hook, experimental). Two Node scripts (Node >= 22, no dependencies) and an installer (PowerShell 7+) that points the client settings at them.
## Install
```powershell
pwsh scripts/Install-Statusline.ps1 -WhatIf # show what would change
pwsh scripts/Install-Statusline.ps1 # install for Claude Code (default)
pwsh scripts/Install-Statusline.ps1 -Client copilot # or: all
pwsh scripts/Install-Statusline.ps1 -NoContextWarning # without the context warning hook
pwsh scripts/Install-Statusline.ps1 -Force # replace a statusLine / subagentStatusLine you set yourself
pwsh scripts/Install-Statusline.ps1 -Uninstall # remove only our entries (and copies of older versions)
```
The installer points `statusLine` and `subagentStatusLine` at the skill's own scripts and registers the context warning hook (`UserPromptSubmit` for Claude Code, `postToolUse` for Copilot CLI with `-Client copilot|all`; `npx skills` installs no hooks), with no copy, so `npx skills update` refreshes them, keeps every other settings key, writes a backup first and is idempotent. A foreign entry is refused without `-Force`. Restart Claude Code to see the lines. Details (paths, `-Client copilot`, migration, `-Uninstall`): https://github.com/GravionLabs/skills/blob/main/docs/usage/statusline.md.
## What you get
| Script | Output |
| :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `statusline.mjs` | `user@host:dir`, model, `ctx:<pct>% (<used>k/<size>k)` (no size part without a window size), `(git branch)`, `5h:<pct>% 7d:<pct>%` (each limit green below 50 %, yellow below 80 %, red above; `ctx` yellow from min(50 %, 250k tokens), red from min(80 %, 500k), 50/80 % without a size). Fields that are null or missing are skipped |
| `subagent-statusline.mjs` | one row per subagent: `<agentType> <model> ctx:<pct>% (<k>k/<size>k) · <label>` (`1M` for a 1,000,000 window); yellow from min(50 %, 250k tokens), red from min(80 %, 500k); only `<k>k` when the context window size is unknown |
## Context warning hook
`scripts/context-warning.sh` (bash) warns once the session context reaches `CONTEXT_WARN_TOKENS` (default: `min(50 %, 250k)` of the window size when known (Copilot `maxPromptTokens`, Claude model id `[1m]`), else 150000; an explicit value wins): the user sees a `systemMessage`, the model gets the same text as `additionalContext`: finish the step, write a short hand-off, then `/clear` (or `/compact`). `CONTEXT_WARN_STEP` (default 100000) is the growth before the next warning. `CONTEXT_WARN_DEBUG=1` prints notes on stderr. Never blocks, no network.
## Rules
- Both scripts run on every refresh: no network, always exit 0. Use the installer, never hand-edit `settings.json`.
- Copilot CLI has no subagent status line, and sends no `rate_limits` (the `5h`/`7d` part stays empty); its payload fields are from community guides, not official docs. OpenCode has no equivalent.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |