Skip to content

Commands

CodeOps ships 19 slash commands. Under the plugin they are namespaced as /codeops:<name>; with the dev installer they get short names (/<name>).

Core commands

These do focused jobs of their own:

CommandWhat it does
/gitcmCommit the working tree with a detailed Conventional Commit message.
/gitcmpCommit and push with a Conventional Commit message.
/analyze_projectScan the project's manifests and structure and generate/refresh its CLAUDE.md (toolchain, commands, structure, conventions). Merges non-destructively. Add --compact (with --dry-run) to slim an already-bloated CLAUDE.md, preview-first.
/migrate_clinerulesConvert a legacy codeops-mcp .clinerules/project.md into this project's CLAUDE.md, preserving hand-authored content.
/clean_jsdocRetrofit an existing project's JSDoc and code comments to the CodeOps documentation standard — strip references to ephemeral planning artifacts (plans/, requirements/, RD/AR IDs), document non-trivial entities, and add @example to public API. Detection-first, comments-only; --dry-run / --refs-only.
/gh_issuesTabular overview of a GitHub repo's issues — number, title, type, priority, effort, dependencies, assignee — with the semantic columns resolved through the repo's own label scheme, native issue types, and project fields (discovered per run, never imposed). Read-only; never mutates issues.
/gh_closeClose one or more GitHub issues by number with GitHub's native close reasons — completed (default), not planned (--wontfix), or duplicate (--duplicate <#N>) — or reopen with --reopen. Echoes each issue's title before acting and pauses when other open issues depend on the one being closed. Manual-only — never fires on the model's own initiative.
/codeops_statsRelay the local telemetry tables — event counts, per-agent runs and acceptance rates, durations, emission gaps (--since <Nd>, --project <p>, --by agent|lens|project|event, gaps). Metadata-only and local; the raw events file is never read into context. See Telemetry.
/codeops_retroQuality retrospective over the telemetry: applies the thresholds (acceptance, gap rate, blocker categories, dead lenses) and sorts what triggers into plugin-tuning vs profile-tuning recommendations. Terminal-only; recommends, never applies. See Telemetry.

Alias commands

The consolidated skills cover several verbs each. Thin alias commands make each verb directly typeable by delegating to the parent skill in the right mode. These are manual-only — only the parent skills auto-trigger from natural language.

Alias commandDelegates to
/add_requirement, /review_requirementsmake_requirements
/make_techdocs, /review_techdocstechdocs
/make_roadmap, /update_roadmap, /review_roadmap, /show_roadmap, /archive_roadmaproadmap
/upgrade_requirementsupgrade_plan
/setup_routingsetup_routing
/setup_codeopssetup_codeops

Example

text
/codeops:gitcmp

Stages the working tree, writes a Conventional Commit message describing the change, commits, and pushes. Used by exec_plan in --auto-commit mode after each verified task.

Keeping CLAUDE.md lean

CLAUDE.md is injected into every session, so its size is a permanent per-session cost. CodeOps keeps it lean on both ends:

  • Generation stays terse by default — the Project structure section is one line per top-level item, the routing block is a ≤10-line sentinel span, and the analyze_project refresh comment is replaced in place instead of stacking up every run.
  • Cleanup for a file that has already grown/analyze_project --compact measures it against the budgets (whole file ≤150 lines; derived Project structure ≤20; routing span ≤10; one refresh comment; no pasted-in coding standards), then previews a slimmed version and asks before writing. --compact --dry-run reports without writing. It works on the current project only and advisory-flags — never silently rewrites — your hand-authored sections.

Released under the MIT License.