repo
claudeFor every project: worktrees, merge, release, cleanup, backlog, branch guard, protected files, per-file check, context7
21 skills · 1 MCP server · hooks
The repo plugin under its old name, for machines moving from kiln: install repo@ion-repo instead
Plugin kiln from marketplace ion-repo in antoine-tena/ion-repo. Commands read from the repo's manifest — 2 days ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use and it starts local MCP servers. The exact commands are listed below; read them before installing.
adoptBring a repo that ion-repo did not generate to the level of ion repo new (ion repo adopt) - Claude rules, charter, pre-commit, CI, backlog, ion repo update afterwards - without overwriting a file, on a branch then merged. Use when the user asks to adopt ion-repo in an existing repo.
backlogPicks, adds, starts, closes tickets in docs/backlog/backlog.md; plans releases. Use for what to do next, noting a task or idea, a ticket started or finished, planning versions.
cleanupRemove the worktrees and local branches already merged into the integration branch, and the leftovers (agent worktrees, orphan directories). Use when the user asks to clean up worktrees or branches.
colorChange the color of the bar beside the person's messages in the chat, or of the gray one of a task or another session - a palette, more on request, any color named. Use when the user wants another color for their messages or the gray ones, or from `/repo:look`.
contributionHandle an outside contributor's pull request like a well-run open-source project: safety check of the untrusted code, triage, review, then merge with credit, ask for changes, finish it or close it kindly; nothing posted without the user's yes. Use when such a PR arrives or the user asks about one.
good-first-issuesKeep a small stock of `good first issue` issues open on GitHub, drawn from the backlog for outside contributors; nothing posted without the user's yes. Use when the user asks for good first issues or to attract contributors, or when /repo:contribution has just merged a PR that closed one.
lookChange the look of the chat and the status line in one form - the person's color, their name, their Claude's, the status line's colors - each kept by default. Use when the user wants to customize the chat or the status line, or says yes to the look question at session start.
mergeFinishes work: fast linters on changed files, new duplicated code judged, merge into develop, push, delete branch and worktree, update the repo's plugin. No CI. Use at end of work or when asked to merge.
modernizeClose the grid gaps that need judgment (split a big file, name with meaning, type strictly, write tests) one by one from `ion repo score --roadmap`: tests first, proof by `--rule ID`, one commit per gap. Use when the user asks to modernize a repo, raise its score or work the roadmap.
namesChoose the names above the chat's messages - the person's, their Claude's, a task's or another session's - by default their git name, Claude and each one's own. Use when the user wants another name for themselves, Claude or a gray message in the chat, or from `/repo:look`.
pauseKeep this session's place before leaving it open or closing the computer - its name, where it stopped, the next step - so the next session start, in any repo, lists it with the command that resumes it. Use when the user says they stop, pause, come back later, or asks which session to resume.
promptWrite a clean prompt, ready to paste, for a Claude Code session, a subagent, a system prompt or another model - goal and why, the session's context, limits, done-when, output. Use when the user asks to write, clean up or improve a prompt, or to turn a request into one.
releaseShips a release: release/vX.Y.Z branch, full checks, announcement, main tagged, deployment, back into develop. Use to release, ship, deploy a version, or for an urgent production fix.
reportReport a defect of ion-repo (generated file, charter rule, plugin skill or hook, reusable workflow, command) to antoine-tena/ion-repo: a PR when the fix is clear, an issue otherwise, only with the user's consent. Use when a problem comes from ion-repo ([REPORT-TO-ION-REPO]) or the user asks.
resizeMove a repo up or down ion-repo's sizes (tiny, small, medium, large) - what the new size brings or removes shown before the merge, the settings that go with it, ion repo set on a branch, merged. Use when the user asks to change a project's size, or it outgrew its size or is heavier than it needs.
reviewReviews a branch's commits and diff before public: messages, authorship, trailers, stray files, secrets, fixups; tidies history. `--repo`: whole repo. Run by /repo:merge, /repo:release; use if asked whether it is clean.
skillWrite or sharpen a skill of an Ion tool's plugin - intent, SKILL.md in the right craft's plugin, one trigger case, docs; tested with `claude plugin eval` only on request. Use when the user wants a new skill, to fix one, or to check one fires and does its job.
statuslineChange the look of the status line - its style, its colors, among them the chat's (the person's and Claude's) - each shown before it is chosen. Use when the user wants another status line, other colors for it, or from `/repo:look`.
tokenSet up a service's credentials (PyPI, Stripe, an API, a host…) in a `.<service>/` folder at the repo root (`token`, chmod 600, and `config` on its scope), with one command that pastes the token unseen. Use when a task needs an API key or a token, or when the user wants to give one.
updateUpdate ion-repo - the ion-repo tool of the machine and its plugins, then the open repo (ion repo update, on a branch merged right away into develop). Use when the user asks to update ion-repo, or accepts the update offered at session start.
worktreeCreate a work branch in a ready-to-use git worktree. The normal way to start a branch, so as not to cross another session in the main tree.
context7runs: npx -y @upstash/[email protected]
python3 "${CLAUDE_PLUGIN_ROOT}/hooks/branch_guard.py"
python3 "${CLAUDE_PLUGIN_ROOT}/hooks/rtk.py"
python3 "${CLAUDE_PLUGIN_ROOT}/hooks/protect_files.py"
python3 "${CLAUDE_PLUGIN_ROOT}/hooks/check_file.py"
python3 "${CLAUDE_PLUGIN_ROOT}/hooks/session_start.py"
python3 "${CLAUDE_PLUGIN_ROOT}/hooks/first_prompt.py"
For every project: worktrees, merge, release, cleanup, backlog, branch guard, protected files, per-file check, context7
21 skills · 1 MCP server · hooks
Nuxt, Vue, Vitest, preview and visual audit, playwright MCP server
6 skills · 1 MCP server
Django: migrations, OpenAPI contract, read-only postgres MCP server
3 skills · 1 MCP server
Read-only Serena MCP server: symbol navigation for large repos
1 MCP server
Stripe MCP server, test mode only
1 MCP server
The debrief output style alone, for a machine without the repo plugin: end-of-work report read in five seconds
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.