oh-my-claude

Your Claude Code session is invisible. oh-my-claude makes it visible.

Context window filling up? You won't know until Claude gets confused. Burning $15/hour? No indicator. CI failed after your last push? Switch to a browser to find out. Dev server crashed? You'll debug for 10 minutes before noticing.

oh-my-claude puts all of this in your statusline:

 Opus myproject main ↑2  ✓ CI  2h ago                   5h 12% ~4h30m $0.36/m
 ▓▓▓▓▓▓▓░░░░░░░░░░░░░ 35%  ● :3000                          $1.23  15m 0s

npm install -g @npow/oh-my-claude
omc install

Two commands. Takes effect immediately.

87 plugins. 12 themes. Zero npm dependencies. Write your own in minutes.

Know when you're running out -- context bar turns yellow at 60%, red at 80%:

  ▓▓▓▓▓▓░░░░░░░░░ 30%     ← green
! ▓▓▓▓▓▓▓▓▓░░░░░░ 60%     ← yellow
- ▓▓▓▓▓▓▓▓▓▓▓▓░░░ 80%     ← red, time to /compact

Know what you're spending -- cost rate, per-line cost, usage limits:

$0.36/m  $4.56  3¢/line  5h 12% ~4h30m | 7d 30%

Know if your stuff is working -- dev server, CI, PR status:

● :3000  ✓ CI  PR #42 ✓ approved  3 reviews

Or just have fun -- virtual pets, RPG stats, fortune cookies:

(^.^) Lv.9 STR:18 DEX:4  🔥 7d streak  🥠 "Ship it." — @chad

omc theme <name>

See screenshots below.

Everything ships in the box. Just omc add <name>. Plugins that need external tools hide gracefully if the tool isn't installed.

omc add spotify                    # add a plugin
omc add localhost --line 2         # pick position
omc config localhost port=8080     # configure it
omc set 1 --left model-name git-branch --right session-cost
omc show                           # preview your layout
omc theme save my-setup            # save as a theme

// ~/.claude/oh-my-claude/plugins/my-plugin/plugin.js
export const meta = {
  name: 'my-plugin',
  description: 'Shows something useful',
  defaultConfig: { style: 'cyan' },
};

export function render(data, config) {
  const value = data?.cost?.total_cost_usd;
  if (value == null) return null;
  return { text: `$${value.toFixed(2)}`, style: config.style };
}

Three rules: export meta, export render, return { text, style } or null.

omc create my-plugin        # scaffold it
omc test my-plugin           # test with mock data
omc add my-plugin            # activate it

Script plugins work too (Python, Bash, etc.) -- omc create my-plugin --script.

Full API reference: docs/plugin-contract.md

omc install                  Setup wizard
omc show                     Current layout + preview
omc add/remove <name>        Toggle plugins on the statusline
omc set <line>               Set a line (--left p1 p2 --right p3)
omc theme <name>             Switch theme
omc theme save <name>        Save current layout as theme
omc config <name>            Show/set plugin config
omc info <name>              Plugin details
omc test <name>              Test a plugin with mock data
omc list                     All plugins
omc doctor                   Diagnose issues
omc create <name>            Scaffold a new plugin
omc install <url>            Install community plugin from git

• Node 18+ (ships with Claude Code)
• Zero npm dependencies

PRs welcome. One file per plugin, export meta + render, handle nulls, run npm run validate.

MIT