Skip to content

CLI Installation

Install PAW agents and skills to your GitHub Copilot CLI configuration.

Prerequisites

Quick Start

npx @paw-workflow/cli install copilot

This installs PAW agents and skills to ~/.copilot/, making them available in your Copilot CLI sessions.

Commands

Command Description
paw install copilot Install PAW to GitHub Copilot CLI
paw list Show installed version and components
paw upgrade Check for and apply updates
paw uninstall Remove all PAW files

Use --force or -f to skip confirmation prompts.

What Gets Installed

Agents

Two agent files are installed to ~/.copilot/agents/:

  • PAW.agent.md - The main PAW workflow orchestrator for implementation workflows
  • PAW-Review.agent.md - The PAW Review workflow orchestrator for code review

Skills

Activity and utility skills are installed to ~/.copilot/skills/, including:

  • Specification skills: paw-spec, paw-spec-research, paw-spec-review
  • Planning skills: paw-planning, paw-plan-review, paw-code-research
  • Implementation skills: paw-implement, paw-impl-review, paw-git-operations
  • Review skills: paw-review-* (9 skills for the review workflow)
  • Utility skills: paw-status, paw-workflow, paw-docs-guidance, paw-rewind, paw-work-shaping, paw-transition

Using PAW After Installation

After installation, start a Copilot CLI session and invoke PAW:

# Start implementation workflow
copilot --agent PAW

# Start review workflow  
copilot --agent PAW-Review

Or use /agent inside an existing session to select a PAW agent.

See Two Workflows for detailed usage instructions.

Updating

Check for updates and upgrade:

npx @paw-workflow/cli upgrade

Or reinstall to get the latest version:

npx @paw-workflow/cli install copilot --force

Uninstalling

Remove all PAW files:

npx @paw-workflow/cli uninstall

This removes installed agents, skills, and the manifest file.

Troubleshooting

"Distribution files not found"

The package may be corrupted. Try reinstalling:

npm cache clean --force
npx @paw-workflow/cli install copilot

Files not showing in Copilot CLI

Verify the files were installed:

ls ~/.copilot/agents/
ls ~/.copilot/skills/

Restart your Copilot CLI session after installation.

Permission errors

Ensure you have write access to: - ~/.copilot/ — where agents and skills are installed - ~/.paw/copilot-cli/ — where the manifest file is stored