Connect your agent app

Add the MiniCut skill and its allow and ask-first rules to your coding agent app, then check that the app has them.

MiniCut supports 11 coding agent apps: 10 with a skill folder, and WorkBuddy by upload. Do this for each one you use. The install prompt in Install with your agent already adds the skill and runs minicut agent-rules. Use this page to add another app later, or to repair one.

Every command here needs MiniCut installed. minicut install-skill and minicut agent-rules work on a computer that is not signed in.

Check which apps have the skill

1. Run this command:

minicut install-skill --status

It lists every agent app whose home folder is on this computer. Each line says installed with the skill folder, or not installed with the command to run.

2. For a script, add --json. It prints every app below, with found, installed and path. With no agent app on this computer, --status --json prints JSON. The line No agent app home folder found under your home folder is printed without --json.

Add the skill to one app

1. Pick the app from the table. The id is the value for --app.

2. Run the command with that id:

minicut install-skill --app claude-code

3. If the app is open, restart it so it loads the skill.

The command copies the skill into a folder named miniharness-short-drama in the skill folder. If that folder holds your own earlier copy, add --force to replace it. If it holds a different skill, the command does not touch it.

Several apps share .agents/skills. One copy there serves all of them.

For WorkBuddy, minicut install-skill --app workbuddy prints the command that builds a ZIP file. Upload that ZIP in WorkBuddy under 技能 > 添加技能 > 上传技能.

Add the skill to every app on this computer

1. Run this command:

minicut install-skill --all-found

Claude Code: skill written to ~/.claude/skills/miniharness-short-drama. Restart Claude Code if it is open, so it loads the skill.
Codex: skill written to ~/.agents/skills/miniharness-short-drama. Restart Codex if it is open, so it loads the skill.
Claude Code: added the loop hooks (Stop, PreToolUse) to ~/.claude/settings.json
Codex: added the loop hooks (Stop, PreToolUse) to ~/.codex/hooks.json
Codex: open Codex and type /hooks once to trust the two MiniCut hooks; until then Codex skips them.

2. Restart each app that is open.
3. In Codex, open Codex and type /hooks once to trust the two MiniCut hooks. Codex skips them until you do.

Hooks for Claude Code and Codex

For Claude Code and Codex, the install adds two hooks next to the skill. They keep your agent inside the loops:

Claude Code keeps its hooks in ~/.claude/settings.json, and Codex in ~/.codex/hooks.json. The install merges them with your other hooks, and a second run changes nothing. OpenCode has no stop hook, so it gets no loop guard. The skill tells its agent to run minicut loop next instead.

Add the rules for Claude Code and Codex

1. Run this command:

minicut agent-rules

Claude Code: added to ~/.claude/settings.json:
  permissions.allow: Bash(~/.minicut/bin/minicut *)
  permissions.ask: Bash(~/.minicut/bin/minicut uninstall*)
  permissions.ask: Bash(~/.minicut/bin/minicut * --yes*)
  sandbox.excludedCommands: ~/.minicut/bin/minicut *
Codex: added to ~/.codex/rules/default.rules:
  prefix_rule(pattern=["~/.minicut/bin/minicut"], decision="allow")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "uninstall"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "gen"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "board", "run"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "check", "8"], decision="prompt")
  prefix_rule(pattern=["~/.minicut/bin/minicut", "write"], decision="prompt")
  Codex reads its rules when it starts: restart Codex to use them.

2. Restart Codex if it is open.

The command writes one edit for each app it finds, with the full path of minicut on this computer. It keeps everything already in the file and never writes a rule twice. Run again, it prints already has every Minicut rule. Nothing changed.

On macOS and Linux, the Claude Code rules also list minicut as a command that runs outside the app's sandbox.

To see the rules without writing them, add --dry-run. To write for one app, add --app claude-code or --app codex. Add --json for one JSON object.

Check it worked

Run minicut install-skill --status again.

Claude Code: installed, ~/.claude/skills/miniharness-short-drama
Codex: installed, ~/.agents/skills/miniharness-short-drama

Errors

Next