@paw-workflow/cli

CLI installer for Phased Agent Workflow (PAW) agents and skills.

Installation

# Install to GitHub Copilot CLI
npx @paw-workflow/cli install copilot

# Install to Claude Code CLI
npx @paw-workflow/cli install claude

This installs PAW agents and skills to the target CLI's configuration directory (~/.copilot/ or ~/.claude/).

You can install to both targets:

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

Commands

install

Install PAW agents and skills to a target environment.

paw install copilot          # GitHub Copilot CLI
paw install claude           # Claude Code CLI
paw install copilot --force  # Skip confirmation prompts

list

Show installed version and components (checks all targets).

paw list

upgrade

Check for updates and upgrade all installed targets.

paw upgrade

uninstall

Remove all PAW agents and skills from all installed targets.

paw uninstall
paw uninstall --force  # Skip confirmation prompt

Requirements

• Node.js 18.0.0 or later
• GitHub Copilot CLI and/or Claude Code CLI

What Gets Installed

• Agents: PAW workflow orchestrators (PAW.agent.md, PAW-Review.agent.md)
• Skills: Activity and utility skills for specification, planning, implementation, and review workflows

Files are installed to:

| Target | Agents | Skills | Manifest | |--------|--------|--------|----------| | copilot | ~/.copilot/agents/ | ~/.copilot/skills/ | ~/.paw/copilot-cli/manifest.json | | claude | ~/.claude/agents/ | ~/.claude/skills/ | ~/.paw/claude-cli/manifest.json |

License

MIT

Development

Setup

cd cli
npm install

Build

Build the distribution (processes conditionals, injects version metadata):

npm run build

This creates dist/ with processed agents and skills for the npm package.

Plugin Distribution

The Copilot CLI plugin reads plugin.json from the repository root on main. The agents/ and skills/ directories on main serve as the canonical source for plugin installation:

copilot plugin install lossyrob/phased-agent-workflow

Users wanting versioned/stable installs should use the npm CLI (npx @paw-workflow/cli@<version>).

Test locally

Run the CLI directly without installing:

# Show help
node bin/paw.js --help

# Install to Copilot CLI (from local build)
node bin/paw.js install copilot

# Install to Claude Code CLI (from local build)
node bin/paw.js install claude

# List installed version
node bin/paw.js list

Run tests

npm test

Lint

npm run lint

Publishing

Publishing is automated via GitHub Actions on tag push:

git tag cli-v0.0.1
git push origin cli-v0.0.1

This triggers npm publish — publishes @paw-workflow/cli to npm and creates a GitHub Release.

Requires NPM_TOKEN secret configured in the repository.