A collection of plugins (skills and hooks) for Claude Code and OpenAI's Codex CLI, from Christopher Boone.
- Install: Claude Code, Codex CLI, OpenCode
- Moved and removed plugins
- Skills: Git, Issues and Worktrees, Code Review, Code Quality, Writing, Scaffolding, CI and Release, Agents
- Hooks
- Using with Codex CLI
- License
From within claude, open the plugins manager via /plugin, tab to Marketplace, and hit enter on Add Marketplace. Type cboone/agent-harness-plugins, then choose which plugins to install.
Or, from within claude:
/plugin marketplace add cboone/agent-harness-pluginsRegister the marketplace, then install the plugins you want:
codex plugin marketplace add cboone/agent-harness-plugins
codex plugin add commit@agent-harness-pluginsSee Using with Codex CLI below for selective installation, hook review and trust, refreshing and removing plugins, troubleshooting, and Codex-specific limitations.
OpenCode is no longer supported. The last dist/opencode/ mirror is available at commit 41605e95.
Reinstall the destination plugin and update saved invocations using this mapping. Related workflows share plugins; focused workflows live in their existing hosts. Old plugin registrations are removed. Qualified invocations identify the plugin and skill. Claude Code still resolves the bare names create-worktree and create-issue to their destination plugins.
| Former plugin or skill | Install plugin | Invocation or workflow |
|---|---|---|
create-worktree |
workmux |
/workmux:create-worktree |
address-issue-in-worktree |
workmux |
/workmux:start-issue |
monitor-pr |
monitor-pr |
/monitor-pr:monitor |
resolve-copilot-pr-feedback |
monitor-pr |
/monitor-pr:resolve-copilot-feedback |
merge-main |
sync-with-main |
/sync-with-main:merge |
rebase-onto-main |
sync-with-main |
/sync-with-main:rebase |
review-dependabot-config |
dependabot |
/dependabot:review-config |
triage-dependabot-prs |
dependabot |
/dependabot:triage-prs |
create-issue |
use-git |
/use-git:create-issue |
add-goreleaser-homebrew |
set-up-installers |
GoReleaser mode |
write-homebrew-formula |
set-up-installers |
Homebrew formula mode |
add-cobra-version |
scaffold-go-cli |
Existing CLI version mode |
check-zsh-scripts |
write-zsh-scripts |
Lint workflow |
write-lean-tests |
write-lean-code |
Mirrored test-library reference |
optimize-runner-usage |
set-up-ci |
Runner-usage mode |
add-community-files |
scaffold-new-repo |
Community-files mode |
Install the destination using /plugin install PLUGIN@agent-harness-plugins in Claude Code or codex plugin add PLUGIN@agent-harness-plugins in Codex CLI, replacing PLUGIN with the table's Install plugin value. For example:
/plugin install workmux@agent-harness-plugins
codex plugin add workmux@agent-harness-plugins
Folded workflows retain requests such as "add a version command", "add community files", "reduce CI costs" and "write a Homebrew formula". They run only the selected mode when updating an existing project. See each destination's README for usage and requirements.
Each skill links to its own README. The Trigger column shows the slash command. Some style-guide skills also activate automatically when you touch their target file types; see the per-plugin README for activation rules.
| Plugin | Trigger | What it does |
|---|---|---|
| Commit | /commit |
Smart, context-aware git commits with conventional commit messages and plan awareness. |
| Sync With Main | /sync-with-main:merge, /sync-with-main:rebase |
Merge or rebase the base branch into the current branch, resolve conflicts, and push using the selected workflow. |
| PR | /pr |
Lint, commit, push, and create a pull request in one step with no prompts. |
| Release | /release |
Prepare a versioned release: update release files, create a release commit, tag locally, and optionally publish a GitHub Release. |
| Review Branch | /review-branch |
Review and evaluate all work done on the current branch: summarize changes, assess plan compliance, and evaluate code quality. |
| Use Git | /use-git:use-git, /use-git:create-issue |
Apply git and GitHub CLI conventions for tmpfile bodies, signed commits and safe pushes, and create GitHub issues. |
External tools:
- PR, Use Git:
gh - Sync With Main, Review Branch:
ghfor default-branch detection; each falls back to a local git query if unavailable - Release:
jqfor marketplace catalog releases;ghoptional for GitHub Release creation
| Plugin | Trigger | What it does |
|---|---|---|
| Dots | /dots |
Print 50 dot lines to scroll the visible conversation off screen while keeping the session. |
| Address Issue | /address-issue <issue> |
Fetch a GitHub issue, plan the work, stop for approval, then execute changes and commit with issue references. |
| Workmux | /workmux:create-worktree <issue-or-description>, /workmux:start-issue <issue> |
Create worktrees, branches and tmux windows with workmux, or launch issue planning in a new session. |
| Create Deferred Issues | /create-deferred-issues |
Scan the session, branch, and pull request for concerns set aside as out of scope, propose them as one batch, and file the approved ones as GitHub issues. |
| Suggest Next Issue | /suggest-next-issue |
Recommend the next open GitHub issue in a focused terminal answer, with reasoning, progress signals and resource constraints. |
| WTAF | /wtaf |
Summarize where the conversation, branch, and tasks stand and what comes next, with a thorough mode that also reads the history. |
External tools:
- Address Issue, Create Deferred Issues, Suggest Next Issue:
gh - Workmux:
workmux, plusghwhen given an issue number andjqfor an issue number or a resource claim - WTAF: optional
ghfor pull request, issue, and CI state; without it, the summary uses the conversation and local git alone
| Plugin | Trigger | What it does |
|---|---|---|
| Address Review | /address-review <path> |
Parse a review document for actionable feedback, work through items systematically, and track resolution progress. |
| Review Anti-Patterns | /review-anti-patterns |
Review a branch or a fix diff against a checklist of defects that survive local review, with read-only reports by default and an explicit edit mode for supported fixes. |
| Review Colleague PR | /review-colleague-pr |
Review a colleague's pull request carefully and considerately from a checkout of its branch, and report a brief, read-only assessment in chat: requirements, direction, blockers, follow-ups, and questions for the author. |
| Review Plan | /review-plan [path] |
Review an implementation plan against the current repository and its explicit dependencies, reporting evidence-backed blockers, required revisions, and optional improvements before work begins. Use when asked to review a plan or assess implementation readiness. |
| Review PR with Codex | /review-pr-with-codex |
Have Codex review the current branch in focused read-only aspects (code, error handling, tests, comments, types), then merge the findings into one report with an action plan. |
| Review Until Clean | /review-until-clean |
Run a reviewer of your choice (a skill, slash command or CLI) over every local change, fix its findings at or above a severity threshold, and repeat until the exact snapshot on disk comes back clean or a round limit stops the loop. |
| Monitor Pr | /monitor-pr:monitor, /monitor-pr:resolve-copilot-feedback |
Monitor a pull request until its checks pass, Copilot signs off on the current head, and it is mergeable, fixing failures along the way, then offer the merge and sync the main worktree once it lands; resolve Copilot feedback on demand. |
| Set-Up Review Config | /set-up-review-config |
Install style-guide review checklists as a Copilot code-review skill, with matching AGENTS.md review rules and a REVIEW.md, so Copilot, Codex, and Claude Code Review apply the same guidance. |
External tools:
- Review Anti-Patterns:
gh(optional; finds the default branch whenorigin/HEADis unset, and reads the open pull request's body);codex(optional report backend);jq(required for--edit, optional for Codex reports). Edit mode also requires Review Until Clean for scope capture. - Review Colleague PR:
gh(required; the skill reads the PR, its linked issues, its reviews, and its CI status over the GitHub API, and writes nothing) - Review Plan:
gh(optional; only for explicitly linked GitHub context) - Review PR with Codex:
codex(required; every aspect runs through Codex, read-only exceptsimplify);jq(required; the bundled helpers emit and validate JSON) - Review Until Clean: a reviewer of your choice (required; any skill, slash command or CLI, installed and authenticated; edits it makes are recorded and, when the round budget allows, reviewed again);
jq(required; the bundled scope helper emits JSON) - Resolve Copilot PR Feedback:
gh(required; the skill reads review threads over the GitHub API and posts its summary comment) - Set-Up Review Config:
git(required; the skill detects file types withgit ls-filesand pins links withgit ls-remote);curl(optional; checks that the bundled checklists match the marketplace)
| Plugin | Trigger | What it does |
|---|---|---|
| Add Scrut CLI Tests | /add-scrut-cli-tests |
Set up scrut snapshot-based CLI integration testing for a CLI project. |
| Handle Secrets | /handle-secrets |
Best practices for handling user-provided secrets in CLI tools: secure input methods, credential storage, secret masking, and language-specific libraries. |
| Lint and Fix | /lint-and-fix |
Detect project linters and formatters, run them with auto-fix, resolve remaining issues, then commit and push the fixes. |
| Plant Defects | /plant-defects |
Prove tests catch defects with checked plants, and gate dependent actions on complete checks at an unchanged tree. |
| Set-Up Linters | /set-up-linters |
Detect project languages, recommend linters and formatters, install them, and generate config files, including Pandoc-academic Markdown presets. |
| Trim Comments | /trim-comments |
Trim and rewrite code comments so each leads with what the code does and the minimum why, cutting trivia, jargon, restatement, and details that go stale. |
| Write Bash Scripts | /write-bash-scripts |
Applies Bash style conventions when creating or editing Bash scripts. |
| Write Go Code | /write-go-code |
Go code style guide based on Google Go Style Guide, Effective Go, Code Review Comments, and Cobra CLI behavior. |
| Write LaTeX | /write-latex |
LaTeX mathematical typesetting style guide based on AMS, IEEE, ISO 80000-2, and Knuth conventions. |
| Write Lean Code | /write-lean-code |
Lean 4 and Mathlib conventions for code, proofs, naming, documentation and compile-time tests that mirror the public library API. |
| Write Real-Time Audio Code | /write-realtime-audio-code |
Write and review real-time audio code: callback safety, bounded cross-thread communication, memory ordering, sample-accurate events, and compatible plugin parameters and state. |
| Write Scrut Tests | /write-scrut-tests |
Applies scrut test style conventions when creating or editing scrut test files for CLI binaries and zsh plugins. |
| Write Zsh Scripts | /write-zsh-scripts |
Zsh scripting conventions for syntax, types, expansion, scope and completions, with a workflow for syntax checks, compilation, linting and formatting. |
External tools:
- Add Scrut CLI Tests, Write Scrut Tests:
scrut(Makefile checks for availability and provides install instructions) - Check Zsh Scripts:
shellcheck,shfmt,shellharden,checkbashisms - Trim Comments:
realpath(GNU coreutils, or macOS 13 and later)
| Plugin | Trigger | What it does |
|---|---|---|
| Publish Report Board | /publish-report-board |
Publish a recurring analysis, such as backlog triage or bug triage, as a live report board with a stable URL, and re-sync it in place as the source data changes. |
| Trim Text | /trim-text |
Trim and rewrite prose and code comments so each leads with what the reader needs and the minimum why, without changing what it says. |
| Write Formalization Roadmap | /write-formalization-roadmap |
Document-structure guide for multi-milestone formalization roadmaps in Lean, Rocq, Isabelle, HOL, and other proof assistants. |
| Write Manual Verification Plan | /write-manual-verification-plan |
Write a numbered, resumable checklist for checks run by hand, where every step says what to do, what you should see, and how to tell nothing from broken. |
| Write Markdown | /write-markdown |
Applies Markdown style conventions when creating or editing Markdown files. |
| Write Math | /write-math |
Mathematical writing and exposition guide based on Tao, Knuth, Halmos, and other leading references. |
| Write Pandoc Markdown | /write-pandoc-markdown |
Pandoc-flavored Markdown conventions for academic papers with LaTeX output. |
External tools:
- Publish Report Board:
jq(required; the bundledreport-boardscript validates and renders board data with it),gh(required for the backlog board, which reads issues, milestones, and pull requests) - Trim Text: an authenticated
ghsession, only for PR and issue bodies;realpath(GNU coreutils, or macOS 13 and later) for symlinked instruction files - Write Manual Verification Plan: an authenticated
ghsession, only when the checklist is kept on an issue rather than in a plan
| Plugin | Trigger | What it does |
|---|---|---|
| Bootstrap Project | /bootstrap-project |
Assess a repository, determine what scaffolding and setup tools are needed, present a plan, and execute them in the correct order. |
| Manage Repo Licensing | /manage-repo-licensing |
Bootstrap, audit, and maintain REUSE-style mixed-license coverage in a repository: LICENSES/, NOTICE, REUSE.toml, SPDX headers, and reuse lint cleanliness. |
| Refresh Project Scaffolding | /refresh-project-scaffolding |
Refresh existing project scaffolding against the latest plugin templates. |
| Scaffold Go Library | /scaffold-go-library |
Scaffold a Go library project with GoReleaser changelog-only releases, golangci-lint, GitHub Actions CI/CD, and Makefile. |
| Scaffold Lean Library | /scaffold-lean-library |
Scaffold a Lean 4 library project with Mathlib or PFR dependencies, Lake test/lint wiring, GitHub Actions CI, text linting, and agent instructions. |
| Scaffold New Repo | /scaffold-new-repo |
Scaffold language-agnostic repository files: LICENSE, README, CHANGELOG, .gitignore, agent config and plans, with optional community files. |
| Scaffold Rust CLI | /scaffold-rust-cli |
Scaffold a complete Rust CLI project with Cargo, cargo-deny, cargo-nextest, git-cliff, GitHub Actions CI/CD, and Makefile. |
| Scaffold Zig CLI | /scaffold-zig-cli |
Scaffold a complete Zig CLI project with build.zig, build.zig.zon, cross-compiled releases, GitHub Actions CI/CD, and Makefile. |
External tools:
- Manage Repo Licensing:
reuse. Install via Homebrew:brew install reuse - Scaffold Go CLI, Scaffold Go Library, Scaffold Lean Library, Scaffold New Repo, Scaffold Rust CLI:
ghto resolve the GitHub owner and create the repository. Each also needs its own toolchain: Go,elan/lakefor Lean, and Cargo for Rust - Scaffold Zig CLI:
ghto resolve the GitHub owner, and Zig 0.16 or later. It runsgit initlocally but does not create a repository on GitHub
| Plugin | Trigger | What it does |
|---|---|---|
| Scaffold Go Cli | /scaffold-go-cli |
Scaffold a complete Go CLI project with Cobra, GoReleaser, GitHub Actions and Homebrew tap support, or add version metadata to an existing Cobra CLI. |
| Pin Everything | /pin-everything |
Pin every version surface in a repository (action SHAs, packageManager integrity digests, dependency exact-pins, runtime version files, install commands) for one-shot supply-chain hardening. |
| Dependabot | /dependabot:review-config, /dependabot:triage-prs |
Review Dependabot configuration and triage open Dependabot pull requests, applying configuration fixes or PR actions as approved. |
| Set-Up CI | /set-up-ci |
Create GitHub Actions CI and matching Makefile targets, or optimize existing workflows with path filters, concurrency groups and job timeouts. |
| Set-Up Secret Scanning | /set-up-secret-scanning |
Set up secret scanning with gitleaks and TruffleHog GitHub Actions workflows and optional gitleaks configuration. |
| Upgrade Everything | /upgrade-everything |
Assess every version reference in a repository, evaluate available upgrades with repo-specific risk and reward, and present selectable upgrade options. |
| Set-Up Installers | /set-up-installers |
Set up installer and distribution methods for Go, Swift, Rust and Zig projects, configure GoReleaser publishing, and write or update Homebrew formulae. |
External tools:
- Monitor PR:
ghandjq(both required; the skill reads check, review, and merge state over the GitHub API and pipes paginated review JSON throughjq) - Pin Everything:
gh,jq; optionalcorepack(only when pinning Yarn or pnpm) andreuse(only in REUSE-licensed repos) - Dependabot configuration:
ghandjq(reads repository settings, labels, alerts, and Dependabot secrets); optionaluvfor schema validation withcheck-jsonschema - Set-Up Installers:
ghto detect the repository owner and probe for ahomebrew-taprepo - Dependabot PR triage:
ghandjq(both required; the bundled script reads PRs, comparisons, and alerts over the GitHub API and summarizes them withjq) - Set-Up Installers: authenticated
ghfor GoReleaser publishing; optionalgoreleaserfor configuration checks; Homebrew for formula validation
| Plugin | Trigger | What it does |
|---|---|---|
| Clean Up Agent Config | /clean-up-agent-config |
Review and reorganize AI coding agent configuration and instruction files across Claude Code, Codex, and Copilot. |
| Create Plugin | /create-plugin |
Guide for creating new plugins in this repository with consistent structure and conventions. |
| Push Notification | /push-notification |
Send push notifications through ntfy when work finishes or needs a decision, on request or from another skill, including from remote and cloud sessions. |
| Use Plannotator | /use-plannotator |
Send answerable asks, review attachments, and follow-ups through Plannotator Inbox. |
External tools:
- Push Notification:
curl7.76.0 or newer,jq, and an ntfy topic on ntfy.sh or a self-hosted server - Use Plannotator: a connected Plannotator Inbox MCP server
Hooks are event-driven; they have no slash-command trigger.
| Plugin | What it does |
|---|---|
| Attention Log | Records every time a Claude Code session waits on a person for permission, or stops because an API error or a safeguard refusal ended its turn, in one JSON Lines file that watchers read. |
| Notify (macOS) | Sends macOS notifications when Claude Code or Codex CLI finishes a task or needs your attention. |
External tools:
- Attention Log:
jq(required);tmux(only inside a tmux session) - Notify:
alerter. Install via Homebrew:brew install vjeantet/tap/alerter
This repository works as a native Codex CLI plugin marketplace. Codex reads the generated .agents/plugins/marketplace.json, which points at committed plugin roots under dist/codex/plugins/. Those generated roots mirror the canonical plugins/* directories and copy every SKILL.md unchanged, so Codex routes on the same skill descriptions as Claude Code.
For per-plugin metadata Codex prefers .codex-plugin/plugin.json when present and falls back to .claude-plugin/plugin.json otherwise. Hook registration requires a .codex-plugin/plugin.json with a non-empty hooks path (for example "hooks": "./hooks/hooks.json"); this lets hook plugins point Codex at a Codex-compatible hook file. Codex exposes PLUGIN_ROOT to plugin-bundled hook commands, plus CLAUDE_PLUGIN_ROOT for compatibility with existing Claude Code plugins.
Registering the marketplace makes its plugins available without installing any of them. Install each plugin you want by name, qualified with the marketplace name agent-harness-plugins:
codex plugin marketplace add cboone/agent-harness-plugins
codex plugin list --marketplace agent-harness-plugins
codex plugin add commit@agent-harness-plugins
codex plugin add pr --marketplace agent-harness-pluginscodex plugin marketplace add also accepts a Git ref (cboone/agent-harness-plugins@main, or --ref) and a local path, such as a clone of this repository.
Start a new Codex session after installing so it loads the new skills. Mention a skill with $commit, or choose it from /skills. Codex also selects a skill on its own when a request matches the skill's description. The Trigger column in the tables above shows the Claude Code slash-command form.
Some workflow skills invoke other skills; for example, pr invokes lint-and-fix. Each such skill lists them in the ## Skill dependencies section of its SKILL.md: install its required skills for the workflow to complete, and its optional skills for the steps that use them.
List installed plugins, refresh them, and remove them:
codex plugin list
codex plugin marketplace upgrade agent-harness-plugins
codex plugin remove commit@agent-harness-plugins
codex plugin marketplace remove agent-harness-pluginscodex plugin marketplace upgrade refreshes a Git-backed marketplace and the installed plugins it provides, including files that changed without a version change. Omit the name to refresh every Git-backed marketplace. upgrade and marketplace remove take the marketplace name, not the owner/repo source used by add.
upgrade does not refresh a local-path marketplace. After pulling changes into a local clone, run codex plugin add again for each installed plugin to replace its cached copy, then start a new session.
When changing plugin metadata, skills, hooks, scripts, or references in this repository, regenerate the Codex marketplace with bin/build-codex-marketplace and commit .agents/plugins/marketplace.json plus dist/codex/.
Plugin hooks need no feature flag, but Codex runs them only after you review and trust them, and installing a plugin does not trust its hooks. After installing notify, open /hooks in a Codex session, review the plugin's hooks, and trust them. Codex records trust against each hook definition's hash, so when an upgrade changes a hook, Codex skips that hook until you review and trust it again.
codex plugin addcannot find a plugin: confirm the marketplace name withcodex plugin marketplace listand the plugin name withcodex plugin list --marketplace agent-harness-plugins.- An installed skill does not appear: confirm that
codex plugin listshows the plugin as installed, start a new session, and check/skills. - Installed files are out of date: run
codex plugin marketplace upgrade agent-harness-pluginsfor a Git-backed marketplace, orcodex plugin addagain for a local-path one. - A hook does not run: open
/hooks, then review and trust it, including after an upgrade that changed it.
- Skill invocations are written in Claude Code syntax. The catalog's triggers, skill prose, and generated worktree prompts write invocations as
/name. In Codex, use$nameor/skillsinstead. Correcting them is milestone 3 of the Codex roadmap. - Workflow adapter adoption is partial. The Git and review chain uses capability-based tools, dependency preflights and parent continuation contracts. Codex signing follows the configured mechanism and reports host restrictions rather than skipping them. The local evaluation record distinguishes tested behavior from unverified live paths. Other workflows, such as
bootstrap-project, still need milestone 3 adoption. - Bundled helper migration is partial. The two monitor skills derive their helper paths from the physical location of the loaded skill, including aliases and symlinks. Other script-backed skills retain cache-search fallbacks; their migration remains milestone 3.
- Installed plugin READMEs have broken links. An installed plugin's links to this README and to sibling plugins resolve to paths that do not exist in the Codex plugin cache. Read plugin documentation on GitHub until milestone 3 corrects them.
notifycovers three Codex events. On Codex,notifywiresStopfor completion,UserPromptSubmitto reset completion deduplication, andPreToolUsefor therequest_user_inputquestion tool.PermissionRequestis deliberately left unwired: it runs before Codex's automatic approval review decides whether to prompt you, so a notification there would announce decisions that need no response. For approval and plan prompts, enable Codex's built-in terminal notifications as thenotifyplugin README describes. Reassessing the other lifecycle events is milestone 3.attention-logregisters no Codex hooks. It records Claude Code sessions only; its Codex manifest exists because every hook plugin needs one, and Codex events would need their own check before they are wired.- End-to-end verification is partial. Linux, multiple cached plugin versions, paths containing spaces, restricted destinations, and complete hook payload coverage are not yet verified; that is milestone 4.
- No custom prompts shipped. Codex's
~/.codex/prompts/mechanism is officially deprecated in favor of skills. This repository ships skills (and hooks), not prompts.
MIT License. TL;DR: Do whatever you want with this software, just keep the copyright notice included. The authors aren't liable if something goes wrong.