Skip to content

Latest commit

 

History

3,409 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code Plugins

A collection of plugins (skills and hooks) for Claude Code and OpenAI's Codex CLI, from Christopher Boone.

Contents

Install

Claude Code

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-plugins

Codex CLI

Register the marketplace, then install the plugins you want:

codex plugin marketplace add cboone/agent-harness-plugins
codex plugin add commit@agent-harness-plugins

See Using with Codex CLI below for selective installation, hook review and trust, refreshing and removing plugins, troubleshooting, and Codex-specific limitations.

OpenCode

OpenCode is no longer supported. The last dist/opencode/ mirror is available at commit 41605e95.

Moved and removed plugins

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.

Skills

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.

Git

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: gh for default-branch detection; each falls back to a local git query if unavailable
  • Release: jq for marketplace catalog releases; gh optional for GitHub Release creation

Issues and Worktrees

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, plus gh when given an issue number and jq for an issue number or a resource claim
  • WTAF: optional gh for pull request, issue, and CI state; without it, the summary uses the conversation and local git alone

Code Review

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 when origin/HEAD is 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 except simplify); 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 with git ls-files and pins links with git ls-remote); curl (optional; checks that the bundled checklists match the marketplace)

Code Quality

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)

Writing

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 bundled report-board script validates and renders board data with it), gh (required for the backlog board, which reads issues, milestones, and pull requests)
  • Trim Text: an authenticated gh session, only for PR and issue bodies; realpath (GNU coreutils, or macOS 13 and later) for symlinked instruction files
  • Write Manual Verification Plan: an authenticated gh session, only when the checklist is kept on an issue rather than in a plan

Scaffolding

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: gh to resolve the GitHub owner and create the repository. Each also needs its own toolchain: Go, elan/lake for Lean, and Cargo for Rust
  • Scaffold Zig CLI: gh to resolve the GitHub owner, and Zig 0.16 or later. It runs git init locally but does not create a repository on GitHub

CI and Release

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: gh and jq (both required; the skill reads check, review, and merge state over the GitHub API and pipes paginated review JSON through jq)
  • Pin Everything: gh, jq; optional corepack (only when pinning Yarn or pnpm) and reuse (only in REUSE-licensed repos)
  • Dependabot configuration: gh and jq (reads repository settings, labels, alerts, and Dependabot secrets); optional uv for schema validation with check-jsonschema
  • Set-Up Installers: gh to detect the repository owner and probe for a homebrew-tap repo
  • Dependabot PR triage: gh and jq (both required; the bundled script reads PRs, comparisons, and alerts over the GitHub API and summarizes them with jq)
  • Set-Up Installers: authenticated gh for GoReleaser publishing; optional goreleaser for configuration checks; Homebrew for formula validation

Agents

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: curl 7.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

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

Using with Codex CLI

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.

Installing and managing 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-plugins

codex 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-plugins

codex 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/.

Reviewing and trusting hooks

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.

Troubleshooting

  • codex plugin add cannot find a plugin: confirm the marketplace name with codex plugin marketplace list and the plugin name with codex plugin list --marketplace agent-harness-plugins.
  • An installed skill does not appear: confirm that codex plugin list shows the plugin as installed, start a new session, and check /skills.
  • Installed files are out of date: run codex plugin marketplace upgrade agent-harness-plugins for a Git-backed marketplace, or codex plugin add again for a local-path one.
  • A hook does not run: open /hooks, then review and trust it, including after an upgrade that changed it.

Codex CLI known limitations

  • 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 $name or /skills instead. 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.
  • notify covers three Codex events. On Codex, notify wires Stop for completion, UserPromptSubmit to reset completion deduplication, and PreToolUse for the request_user_input question tool. PermissionRequest is 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 the notify plugin README describes. Reassessing the other lifecycle events is milestone 3.
  • attention-log registers 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.

License

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.

Releases

Used by

Contributors

Languages