claude-cockpit
Cockpit: a context meter, usage statistics, a focus timer and themes for Claude Code.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/dexipua--claude-cockpit)HTML
<a href="/listings/dexipua--claude-cockpit"><img src="/api/listings/dexipua--claude-cockpit/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
In a Claude Code terminal session:
/plugin install cockpit --marketplace dexipua/claude-cockpit
Answer `y` to add the marketplace, then press Enter for the user scope. It starts working right away.
From a shell:
claude plugin install cockpit --marketplace dexipua/claude-cockpit
In the Claude desktop app: click **+** next to the prompt box → **Plugins** → **Add marketplace** → `dexipua/claude-cockpit` → **Add plugin**.
> **Had `context-meter` installed?** Cockpit includes it. Remove the old one so you don't get two meters: > `claude plugin uninstall context-meter@claude-context-meter`
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 12 lines
- {
- "name": "claude-cockpit",
- "owner": { "name": "dexipua" },
- "description": "Cockpit: a context meter, usage statistics, a focus timer and themes for Claude Code.",
- "plugins": [
- {
- "name": "cockpit",
- "source": "./",
- "description": "Context meter, plan limits, usage statistics, a focus timer and themes for Claude Code, in one configurable mod."
- }
- ]
- }
README.md · README · 143 lines
- # Cockpit for Claude Code
- **Everything you want to keep an eye on while working with Claude, in one mod.**
- How full the context is, how much of your plan is left, where your tokens went this week, a focus timer, and five themes, all adjustable from one Settings tab.
- Roughly how it looks in the terminal:
- ```
- ╭──────────────────────────────────────────────────────────────────────────────╮
- │ Usage ● working stats compact × │
- │ Context 42% · 84k of 200k │
- │ ███████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
- │ 5-hour limit 70% left · resets in 1h 52m Weekly limit 88% left │
- │ ███████████████████████████████░░░░░░░░░░░ ██████████████████████████████░ │
- │ This message 12k (1.4k out) · Session 340k · 18 turns · 92% cached │
- ╰──────────────────────────────────────────────────────────────────────────────╯
- Focus · java lab ████████░░░░ 14:32 left ❚❚ ■
- ```
- ## Install
- In a Claude Code terminal session:
- ```
- /plugin install cockpit --marketplace dexipua/claude-cockpit
- ```
- Answer `y` to add the marketplace, then press Enter for the user scope. It starts working right away.
- From a shell:
- ```
- claude plugin install cockpit --marketplace dexipua/claude-cockpit
- ```
- In the Claude desktop app: click **+** next to the prompt box → **Plugins** → **Add marketplace** → `dexipua/claude-cockpit` → **Add plugin**.
- > **Had `context-meter` installed?** Cockpit includes it. Remove the old one so you don't get two meters:
- > `claude plugin uninstall context-meter@claude-context-meter`
- ## What's inside
- ### 📟 Context meter (above the prompt)
- - Context fill as a bar, turning yellow and red at the levels you choose
- - Your plan's 5-hour and weekly limits: what's left and when they reset
- - Tokens of the last message and of the session, turns, cache hit rate
- - Three sizes: a full **card**, **one line**, or a tiny **chip**, so it takes as much room as you want
- - Optional: the state of your graphify code graph, if you use it
- ### 📊 Statistics (`/cockpit`)
- A pane with tabs, counting across all your sessions:
- | Tab | Shows |
- | --- | --- |
- | **Today** | tokens in/out, cache share, messages, how long Claude worked, focus time, cost estimate, by project |
- | **Week / Month** | a bar per day, totals, average per active day, busiest day |
- | **Projects** | the last 30 days, ranked |
- | **Tools** | which tools Claude reaches for, edits per read |
- | **Habits** | your streak, the hour you work most, weekdays |
- | **Focus** | focus minutes, sessions, daily goal, streak, start/stop buttons |
- | **Settings** | everything below |
- Everything stays on your computer, in Claude Code's own storage for the mod. Nothing is sent anywhere. The cost is an estimate at API prices, not a bill.
- ### 🎯 Focus timer (`/pomo`)
- - `/pomo` starts 25 minutes, `/pomo 50 java lab` starts 50 with a label
- - A progress bar above the prompt with pause and stop
- - A pop-up when it's done, then a one-click break; every n-th break is a long one
- - Optional: start the break by itself, and a daily goal
- - One timer shared by every open session
- ### 🎨 Themes (`/look`)
- | | |
- | --- | --- |
- | `coffee` | crema by day, espresso by night |
- | `kyiv` | clear blue sky over a wheat field |
- | `forest` | moss and pine, a cabin lamp at night |
- | `concert` | velvet seats and warm stage light |
- | `ocean` | sea foam on top, deep water below |
- Each has a light and a dark version. Pick one, or let it change every day or every session. Themes draw in the Claude desktop and mobile apps; the terminal keeps its own colors.
- ## Commands
- | Command | Does |
- | --- | --- |
- | `/cockpit` | open the pane (`/cockpit week`, `/cockpit settings`, …) |
- | `/cockpit set <key> <value>` | change a setting: `/cockpit set focusMin 50`, `/cockpit set theme kyiv`, `/cockpit set limits off` |
- | `/cockpit list` | print every setting with its value |
- | `/cockpit reset` | all settings back to defaults |
- | `/pomo [min] [label]` | focus timer; also `break`, `pause`, `stop`, `stats` |
- | `/meter [small\|detailed\|close]` | resize the meter; `graph` / `all` open the graphify graph (Windows) |
- | `/look [name\|next\|random\|daily\|off]` | switch the theme (`/theme` is Claude Code's own terminal theme picker) |
- If another plugin already uses `/pomo`, `/meter` or `/look`, Cockpit says so once and you can reach the same thing as `/cockpit pomo …`, `/cockpit meter …`, `/cockpit look …`.
- ## Settings
- All of them are in the **Settings** tab (toggles, − / + buttons, pickers), or `/cockpit set <key> <value>`:
- | Key | Default | |
- | --- | --- | --- |
- | `meter.enabled` | on | show the meter |
- | `meter.view` | card | `detailed` card, `compact` line, `closed` chip |
- | `meter.limits` | on | plan limit bars |
- | `meter.tokens` | on | the token row |
- | `meter.graph` | on | the graphify row |
- | `meter.warnAt` / `meter.dangerAt` | 60% / 85% | when the bar turns yellow / red |
- | `focus.enabled` | on | the timer row |
- | `focus.focusMin` | 25 | focus length, minutes |
- | `focus.breakMin` / `focus.longBreakMin` | 5 / 15 | break lengths |
- | `focus.longEvery` | 4 | a long break after every n-th session |
- | `focus.autoBreak` | off | start the break by itself |
- | `focus.toasts` | on | pop-up when a timer ends |
- | `focus.dailyGoalMin` | 120 | daily focus goal (0 = none) |
- | `stats.enabled` | on | collect statistics |
- | `stats.keepDays` | 120 | how much history to keep |
- | `stats.cost` | on | show the cost estimate |
- | `stats.barWidth` | 24 | bar length in the pane |
- | `stats.openAtStart` | off | open the pane when a session starts |
- | `theme.look` | app default | `coffee`, `kyiv`, `forest`, `concert`, `ocean`, `off` |
- | `theme.rotate` | never | `daily`, `session` |
- | `layout.focusFirst` | on | timer above the meter |
- The short key works too: `/cockpit set focusMin 50` is `focus.focusMin`.
- ## Requirements
- - A recent Claude Code (mods are a new feature: update it if the install works but nothing appears)
- - Plan limits appear only when Claude Code reports them (a Claude subscription); with an API key the meter shows context and tokens without them
- ## Development
- ```
- claude plugin validate .
- claude plugin test .
- ```
- `hooks/register.tsx` is the mod, `hooks/lib.ts` the settings schema and helpers, `hooks/looks.ts` the themes, `types/index.d.ts` its state contract.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.