archive-add-guard
Asks before git add stages an archive, installer or database file, or any file over 5 MB
newguard
Asks before git add stages an archive, installer or database file, or any file over 5 MB
An instrument panel for Claude Code. 309 mods for the terminal: 52 panels that stay in sight and switch on and off in /cockpit, plus guards, prompt automations, instant commands and focus helpers. Every mod is a small plugin you install with one line.
/plugin marketplace add MatheusChiodi/cockpit
/plugin install git-band@cockpit
/cockpitMods are TypeScript functions that run inside Claude Code and change how it behaves: they intercept tool calls, rewrite prompts, draw panes and bands, and register slash commands. They need Claude Code 2.1.287 or newer (built against 2.1.296).
From GitHub, inside Claude Code:
/plugin marketplace add MatheusChiodi/cockpit
/plugin install <mod>@cockpitFrom a local folder:
git clone https://github.com/MatheusChiodi/cockpit
claude plugin marketplace add ./cockpit
claude plugin install git-guard@cockpitJust to try one, without installing:
claude --plugin-dir ./cockpit/mods/turn-timerRemove a mod with /plugin uninstall <mod>@cockpit. Turn every mod off at once with claude --safe-mode.
The 52 mods under Always visible are panels: bands above the prompt or status line entries that update on their own (git, context, cost, tests, CI, tasks, deadline, weather). None needs a command to show up.
The cockpit mod is their settings pane, and it comes along as a dependency of any panel.
| To | Do |
|---|---|
| Open the settings pane | /cockpit — Tab and arrows move, Enter or a click toggles, Esc closes |
| Switch a panel off or on | /cockpit off git-band · /cockpit on git-band |
| Switch all of them | /cockpit off all · /cockpit on all |
| Change the language | /cockpit lang en · /cockpit lang pt · /cockpit lang es |
Both choices are kept between sessions. A band disappears or returns at once; a status line entry disappears at once and returns on its next update. A panel switched off stays installed and simply does not draw.
Bands stack in the order the mods load, and the status line holds one entry per mod. With many panels on, the terminal gets crowded: start with four or five and adjust in /cockpit.
Every mod speaks English by default and can switch to Brazilian Portuguese or Spanish. The language is set once, in /cockpit, and every installed mod follows it: band labels, status line words, command output, guard messages, toasts and notifications. Without the cockpit mod installed, mods stay in English.
Slash command descriptions in the typeahead are read when a session starts, so they follow a language change on the next session. To make Claude itself answer in the chosen language, install reply-language.
| Always visible | 53 | cockpit git-band todo-band usage-band files-band error-band goal-band agents-band activity-status test-status ci-status stash-status uncommitted-band pr-status main-warning-band conflict-band project-status ports-band deps-status todo-count-status quality-status model-status cost-ticker idle-clock turn-progress last-prompt-band compact-nudge session-diff-band shield-band reset-countdown spend-today focus-band deadline-band pin-band clock-status day-timer commits-today dolar-status weather-status api-status terminal-pet runtime-band docker-band env-drift-band deploy-status todo-new-status release-status license-status install-status db-port-status migration-status env-ignore-status build-size-status |
| Security | 42 | rm-guard env-guard git-guard secret-scan prompt-secret-guard lockfile-guard path-jail main-branch-guard generated-guard sql-guard prod-guard install-ask pipe-shell-guard big-read-guard sudo-guard chmod-guard docker-guard kill-guard credential-file-guard upload-guard env-dump-guard registry-guard persistence-guard dotfile-guard ci-config-guard test-skip-guard suppress-guard migration-guard large-write-guard tunnel-guard hardcoded-secret-guard private-host-guard dynamic-exec-guard sql-concat-guard tls-off-guard cors-open-guard debug-flag-guard script-mode-guard dep-source-guard weak-crypto-guard gitignore-guard archive-add-guard |
| Interface | 34 | turn-timer tool-tally file-trail cmd-log git-status-line context-meter rate-limit-watch session-clock diff-pane turn-history prompt-history agent-pane token-chart cost-pane error-pane context-pane read-pane links-pane git-pane branch-pane stash-pane code-todo-pane deps-pane scripts-pane env-keys-pane test-pane slow-toast deny-toast big-output-toast timeline tool-clock result-fold group-peek prompt-stamp |
| Prompt and model | 30 | concise-mode persona prompt-shortcuts tldr git-context stack-context commit-style reply-language time-context os-context test-first explain-mode plan-first no-comments minimal-diff ask-first verify-claims paste-fence file-mention-hint trace-helper branch-naming pr-style a11y-rules security-rules react-rules tailwind-rules rn-rules java-rules oracle-rules answer-format |
| Commands | 42 | quick-notes pomodoro copy-last session-stats quote-selection git-peek git-branch git-stash git-undo run-script open-path ports kill-port tree find-file last-error env-check outdated json-tool uuid timestamp base64 hash calc color-tool regex-test http-probe snippets export-session standup loc-count big-files recent-files symbol-def file-author head-file file-diff path-size ignore-check file-compare churn hit-count |
| Focus and notifications | 42 | turn-notify break-reminder daily-streak error-notify needs-you-notify agent-done-notify long-cmd-notify tests-notify ci-notify pr-review-notify rate-limit-notify hydrate posture eye-rest stand-up alarms remind timebox session-cap late-night intent-check daily-target weekly-recap breathe budget-alert daily-budget-alert turn-toast milestone-toast push-reminder idle-commit-nudge topic-switch scatter-toast long-turn-toast step-back branch-drift edits-no-commit day-close quiet-window parking-lot file-churn resume-line wandering |
| Git and GitHub | 24 | commit-review wip-commit-guard marker-guard amend-guard stage-guard git-stage git-fixup git-sync behind-toast git-switch git-tag staged-status pr-open pr-checks pr-comments review-queue issue-context issue-link draft-nag pr-diff merge-ready release-notes changelog-entry merged-branches |
| Quality | 12 | untested-turn-toast red-turn-toast debugger-guard leftovers-toast any-guard long-file-toast dup-block-guard untested coverage-status empty-test-guard snapshot-update-guard catch-swallow-guard |
| Stacks | 12 | pm-guard script-guard missing-import-guard client-env-guard next-boundary-guard esm-guard alias-import-guard dev-server-guard ts-config-context env-undeclared-toast node-version-status pm-command |
| Context and cost | 18 | reread-guard grep-limit read-cap git-log-limit paste-size-toast cat-guard explore-nudge fill-toast cache-cold-toast flood-note heavy-calls tree-flood-guard agent-cap agent-straggler cost-per-hour cost-trend priciest-turn runout-projection |
Every panel is drawn the same way, so several of them read as one instrument:
━━━━───) instead of block bars.label state detail, as in tests ✓ 14:32 · 3.1s.kit/kit.tsx, copied into each mod at build time.| For | Mods |
|---|---|
| An everyday dashboard | git-band usage-band todo-band error-band test-status |
| Git without surprises | git-band conflict-band uncommitted-band main-warning-band pr-status ci-status |
| An eye on spend | usage-band cost-ticker spend-today reset-countdown compact-nudge |
| A seat belt | rm-guard git-guard env-guard secret-scan pipe-shell-guard prod-guard shield-band |
| Less typing | stack-context git-context commit-style prompt-shortcuts git-peek |
| Focus | focus-band deadline-band pin-band turn-notify break-reminder |
hooks/register.ts before installing it; every one here is short.prod-guard, install-ask and the others that say so force the confirmation prompt even when the command was already allowed.dolar-status (AwesomeAPI), weather-status (wttr.in, located by IP), api-status (Anthropic's status page), ports-band (localhost only).ci-status and pr-status need an authenticated gh.$.audio.play only plays on macOS, so notifications use the native channel.npm install
npm run build # manifests, the hub's panel list, previews and the three READMEs
npm run check # tsc + claude plugin validate on every mod + claude plugin test where tests exist
node scripts/mod.mjs <mod> # the same loop for one mod, without touching shared filesmods.json is the single source: name, category, descriptions in three languages and the preview lines of every mod.
mods/<name>/
hooks/register.ts(x) the mod
hooks/strings.ts every user-facing text, in en, pt and es
types/index.d.ts the $.state contract, for mods that draw
tests/ run by `claude plugin test`plugin.json, hooks.json and each mod's copy of the kit are generated.
Adding mods with the agent. The repository ships a Claude Code agent, cockpit-mod-builder (.claude/agents/), that knows the conventions: the language pattern, the visual kit, the engine rules that trip people up, and the one-mod loop. Open Claude Code in the repository and ask for it by name, giving a category and the mods you want.
The type check uses the API declarations Claude Code itself writes. They are not in the repository: run a mod with claude --plugin-dir mods/<name> and copy mods/<name>/.claude-plugin/types/claude-code/index.d.ts plus claude-code-tools/index.d.ts into engine-types/.
Surveyed on 2026-10-13 through gh api and the official documentation. Star counts are from that day.
| Community collection | Stars | Known for |
|---|---|---|
| karanb192/awesome-claude-code-mods | 560 | A catalog of 3,836 mods across 1,987 repositories |
| YeonwooSung/my-claude-code-mods | 514 | agent-profiler, context-inspector, time-machine |
| hamzafer/claude-code-mods | 227 | context-bar, blast-radius, merge-gate |
| zenbu-labs/terminal-browser | 3,854 | A browser inside the terminal |
| jarrodwatts/claude-image-view | 222 | Images in the terminal |
Other ways people customize Claude Code, which are not mods: claude-hud and ccstatusline (status line scripts), ccusage (a CLI over the transcripts), tweakcc (patches the install), cc-safety-net (a PreToolUse hook).
MIT
hooks/register.ts 62 lines1import type { EngineInterface, Register } from 'claude-code'
2
3import { STRINGS } from './strings'
4
5// cockpit: the language set in /cockpit (English when the hub is not installed)
6const LANG = { plugin: 'cockpit', key: 'lang' } as const
7
8const strings = async ($: EngineInterface) => STRINGS[(await $.state.get(LANG)).value ?? 'en']
9
10const GIT_ADD = /\bgit\s+add\b([^|;&\n]*)/
11const BINARY = /\.(?:zip|tar|tgz|gz|bz2|xz|7z|rar|exe|msi|dll|iso|dmg|pkg|dmp|bak|sqlite3?|mdb|psd|mov|mp4|avi)$/i
12const MAX_BYTES = 5 * 1024 * 1024
13const MAX_PATHS = 20
14
15const unquote = (token: string): string => token.replace(/^['"]|['"]$/g, '')
16
17const commandOf = (input: unknown): string => {
18 const value = typeof input === 'object' && input !== null ? (input as Record<string, unknown>).command : undefined
19
20 return typeof value === 'string' ? value : ''
21}
22
23// The confirmation reason, in the session's language; undefined when nothing heavy is being staged.
24const reasonFor = async ($: EngineInterface, tool: string, input: unknown): Promise<string | undefined> => {
25 const args = tool === 'Bash' || tool === 'PowerShell' ? GIT_ADD.exec(commandOf(input))?.[1] : undefined
26
27 if (args === undefined) {
28 return undefined
29 }
30
31 const paths = args
32 .trim()
33 .split(/\s+/)
34 .map(unquote)
35 .filter(token => token !== '' && !token.startsWith('-') && token !== '.')
36 .slice(0, MAX_PATHS)
37
38 for (const path of paths) {
39 if (BINARY.test(path)) {
40 return (await strings($)).binary(path)
41 }
42
43 const stat = await $.fs.stat(path).catch(() => undefined)
44
45 if (stat?.kind === 'file' && stat.size > MAX_BYTES) {
46 return (await strings($)).large(path, (stat.size / (1024 * 1024)).toFixed(1))
47 }
48 }
49
50 return undefined
51}
52
53export const register: Register = on => {
54 // Does not block: asks the person, even when permissions already allow the command.
55 on('tool.check', async ($, e, next) => {
56 const verdict = await next(e)
57 const reason = verdict.decision === 'allow' ? await reasonFor($, e.tool, e.input) : undefined
58
59 return reason === undefined ? verdict : { decision: 'ask', reason }
60 }).catch(() => ({ decision: 'ask', reason: STRINGS.en.failed }))
61}
62hooks/strings.ts 28 lines1const en = {
2 failed: 'archive-add-guard: the check failed, confirm before continuing.',
3 binary: (detail: string) =>
4 `archive-add-guard: git add of a binary or archive (${detail}). It stays in the history forever and weighs on every clone; ignore it in .gitignore, or use Git LFS or a release asset.`,
5 large: (detail: string, mb: string) =>
6 `archive-add-guard: git add of ${detail}, ${mb} MB. It stays in the history forever and weighs on every clone; ignore it in .gitignore, or use Git LFS or a release asset.`,
7}
8
9type Strings = typeof en
10
11const pt: Strings = {
12 failed: 'archive-add-guard: a verificação falhou, confirme antes de continuar.',
13 binary: detail =>
14 `archive-add-guard: git add de um binário ou arquivo compactado (${detail}). Ele fica no histórico para sempre e pesa em todo clone; ignore no .gitignore ou use Git LFS ou um asset de release.`,
15 large: (detail, mb) =>
16 `archive-add-guard: git add de ${detail}, ${mb} MB. Ele fica no histórico para sempre e pesa em todo clone; ignore no .gitignore ou use Git LFS ou um asset de release.`,
17}
18
19const es: Strings = {
20 failed: 'archive-add-guard: la verificación falló, confirma antes de continuar.',
21 binary: detail =>
22 `archive-add-guard: git add de un binario o archivo comprimido (${detail}). Queda en el historial para siempre y pesa en cada clon; ignóralo en .gitignore o usa Git LFS o un asset de release.`,
23 large: (detail, mb) =>
24 `archive-add-guard: git add de ${detail}, ${mb} MB. Queda en el historial para siempre y pesa en cada clon; ignóralo en .gitignore o usa Git LFS o un asset de release.`,
25}
26
27export const STRINGS = { en, pt, es }
28