Skip to content

README.md

Latest commit

 

History

History
83 lines (59 loc) · 2.61 KB

README.md

File metadata and controls

83 lines (59 loc) · 2.61 KB

Canopy Commands

Curated AI agent slash commands for software development workflows. Install directly into your agent's native command system.

Quick Start

npm install -g @canopyide/commands
canopy-commands install --agent claude

Commands install to ~/.claude/commands/canopy/ and are immediately available via /help in Claude Code.

Available Commands

Work Pipeline (/canopy:work)

Fully autonomous issue-to-PR pipeline with 8 phases:

  1. Setup -- Parse input, install dependencies, explore codebase
  2. Research -- Google research grounded in tech stack
  3. Plan -- Implementation plan via Codex
  4. Implement & Test -- Write code and tests, run tests, commit
  5. Review -- Codex code review, fix findings
  6. Verify -- Lint, format, typecheck
  7. Finalize -- Push and create PR
  8. CI Watch -- Monitor CI, fix failures

Usage:

/canopy:work #123
/canopy:work https://github.com/org/repo/pull/456
/canopy:work "Add retry logic to the API client"

Create Issue (/canopy:github:create-issue)

Structured GitHub issue creation with scope assessment and automatic decomposition for large tasks.

Usage:

/canopy:github:create-issue Add dark mode support to settings panel

CLI Commands

canopy-commands install [--agent claude] [--version <ref>]   # Install commands
canopy-commands list [--agent claude] [--installed]           # List commands
canopy-commands sync [--agent claude]                         # Update to latest
canopy-commands search <query> [--agent claude]               # Search commands

MCP Server Dependencies

Some commands use external MCP servers for enhanced capabilities:

  • Codex (mcp__codex__codex) -- Used by the work pipeline for planning and code review. Requires an OpenAI API key and Codex MCP server configuration.
  • Ask Google (mcp__ask-google__ask_google) -- Used by the research phase for web research. Requires a Google API key and Ask Google MCP server configuration.

Commands that require these servers will still run without them but with reduced functionality. The work pipeline's research and planning phases will skip their respective MCP calls and rely on codebase analysis alone.

Supported Agents

  • Claude Code -- Full support (v1)
  • Gemini -- Planned
  • Codex -- Planned

Repository Structure

commands/
  claude/              # Claude Code command files
    work.md            # Work pipeline orchestrator
    work/              # Work pipeline sub-phases
    github/            # GitHub integration commands
packages/
  cli/                 # @canopyide/commands npm package

License

MIT