GitHub Copilot CLI Platform Guide¶

Set up, verify, and recover rp1 on GitHub Copilot CLI.

Prerequisites¶

GitHub Copilot CLI (copilot)
GitHub Copilot CLI enabled for your GitHub account
rp1 CLI installed

Verify Copilot plugin support:

copilot version
copilot plugin --help

Quick Setup¶

Install rp1 into Copilot:

rp1 install copilot

Verify the install:

rp1 verify copilot

The clean result is healthy_native. After installation or update, restart your Copilot CLI session so it reloads rp1.

Run Workflows¶

Inside a Copilot CLI session, invoke rp1 workflows with /rp1-... commands:

/rp1-base-knowledge-build
/rp1-dev-build my-feature
/rp1-dev-pr-review

Pass arguments inline after the workflow name:

/rp1-dev-build my-feature --afk
/rp1-base-deep-research "authentication flow"

Supported User Workflows¶

Goal	Command
Generate project context	`/rp1-base-knowledge-build`
Start a feature	`/rp1-dev-build my-feature`
Make a quick change	`/rp1-dev-build-fast "..."`
Review a PR	`/rp1-dev-pr-review`
Create an onboarding overview	`/rp1-base-project-birds-eye-view`
Open Arcade	`rp1 arcade`

Runs started from Copilot appear in Arcade alongside runs from other supported hosts.

Update¶

rp1 update plugins copilot
# or
rp1 update

Restart your Copilot CLI session after updating.

Uninstall¶

rp1 uninstall copilot

Preview first if needed:

rp1 uninstall copilot --dry-run

The uninstall command removes only rp1-managed Copilot content and preserves non-rp1 Copilot configuration.

Troubleshooting¶

Copilot CLI Not Found¶

Confirm copilot is installed and on your PATH:

which copilot
copilot version

If missing, install it from GitHub's Copilot CLI installation guide.

Copilot Plugin Support Is Missing¶

Confirm the Copilot CLI plugin lifecycle is available:

copilot plugin --help

If that command is unavailable, update GitHub Copilot CLI and confirm Copilot CLI is enabled for your account and organization.

`rp1 verify copilot` Is Not `healthy_native`¶

State	Meaning	What to do
`healthy_native`	Copilot sees the required rp1 plugins and the install is complete.	No action.
`partial_native`	Copilot sees part of rp1, but something is missing.	Re-run `rp1 install copilot`, then verify again.
`legacy_only`	Only an old unsupported rp1 Copilot install was found.	Remove the legacy paths listed by verification, then reinstall.
`mixed_native_and_legacy`	The current install works, but old rp1 files are still present.	Remove only the legacy paths listed by verification.
`not_installed`	No rp1 Copilot install was found.	Run `rp1 install copilot`.

Workflows Still Do Not Appear¶

Restart the Copilot CLI session.
Run rp1 verify copilot.
Confirm copilot plugin list shows rp1-base@rp1-local and rp1-dev@rp1-local.
Re-run rp1 install copilot if either plugin is missing.

Advanced Copilot Reference¶

The sections below are for maintainers and support/debugging sessions. Normal setup should use the quick setup and troubleshooting paths above.

Install Lifecycle¶

rp1 install copilot uses Copilot's native plugin lifecycle. rp1 stages a local rp1-managed marketplace, registers it as rp1-local, then installs or updates the required Copilot plugins from that marketplace.

Surface	Location
Local marketplace metadata	`~/.rp1/copilot/marketplace/marketplace.json`
Local marketplace plugins	`~/.rp1/copilot/marketplace/plugins/rp1-*`
Native installed plugins	`~/.copilot/installed-plugins/rp1-local/rp1-*`
Unsupported legacy footprint	`~/.config/github-copilot/`

Old file-copy paths under ~/.config/github-copilot/ are treated only as legacy leftovers during verification and uninstall.

Dry Run¶

rp1 install copilot --dry-run

Dry-run mode previews the Copilot marketplace registration and plugin install/update actions without mutating Copilot.

Platform Capabilities¶

Capability	Supported
Workflow commands	Yes
Custom agents	Yes
Delegated agent work	Yes
File read/write/edit/search	Yes
Shell command execution	Yes
`rp1 agent-tools` commands	Yes
Parallel delegated work	Yes
Inline argument recovery	Yes
`AGENTS.md` instruction loading	Yes

Tool Name Mapping¶

Copilot CLI uses its own tool names. rp1 translates generated tool references for Copilot during the build process.

rp1 abstract tool	Copilot CLI tool
Read	`read` / `view`
Write	`edit`
Edit	`edit`
Grep	`grep` / `search`
Glob	`glob` / `search`
Bash	`bash` / `shell` / `execute`
Task	`task` / `agent`
Skill	`skill`
WebFetch	`web_fetch`
AskUserQuestion	`ask_user`

Maintainer Iteration¶

Use this loop only when developing Copilot support locally:

just copilot

This auto-builds stale Copilot plugin roots and launches Copilot with local build outputs. It does not install into the supported rp1-local target.

Before release or when validating the supported user path, use the install-like flow:

just build-copilot
./bin/rp1 install copilot --yes --artifacts-dir dist/copilot
./bin/rp1 verify copilot
copilot

Release-readiness validation should end in healthy_native.