Installation

Two commands inside Claude Code. Nothing to compile, no package manager, no native dependencies.

Requirements

• Claude Code, with a Claude Pro or Max subscription for measured usage numbers (an API-key setup falls back to a token estimate).
• Node 22.13 or later on your PATH. The hooks and the MCP server are plain Node scripts.
• git on your PATH, for checkpoints (Pro). Without it, checkpoints report themselves unavailable and everything else works.
• macOS, Linux or Windows. Nothing uses a shell.

Install

>/plugin marketplace add Orstrum/imagine
>/plugin install orstrum@orstrum

Start a new session afterwards so the MCP server is picked up. You'll see one line at the top of the first session: the budget, and an offer to add the status line.

Status line (optional, recommended)

>/orstrum:orstrum statusline

Adds [orstrum 31%w · ok] under the prompt: your share of the binding weekly limit and the current mode. It shows [orstrum · stale] when the last reading is over two hours old. The command shows you the exact statusLine entry and only merges it into ~/.claude/settings.json if you agree; an existing status line is left alone.

Pro

Mint a key in the dashboard and activate it once per machine:

>/orstrum:orstrum license ork_…

See Pro license for how verification and the offline grace work.

Developing against a checkout

To run the plugin from a local clone (a rebuild takes effect without reinstalling):

$pnpm install && pnpm -r build
$claude --plugin-dir /path/to/imagine/plugin