copilot-sdk-e2e-devlisted
Install: claude install-skill sarptandoven/doppl-multiplayer
# Copilot SDK harness: end-to-end dev & testing
The `copilot` harness drives the **GitHub Copilot SDK** (`github-copilot-sdk`,
imported as `copilot`) — a persistent `CopilotClient` + `CopilotSession` per
Doppl conversation — and bridges Doppl's `sys_*` tools into Copilot as SDK
`Tool`s. The Python SDK **bundles the Copilot CLI binary it drives** as a backing
server, so there is no separate `@github/copilot` install. This skill is the
proven recipe for running it **for real** against a live local server — not just
the unit tests.
> The harness runs as a **local runner** from your current checkout, so
> `omni run <bundle> --server <url>` exercises exactly the code you're on.
## Prerequisites (check these first)
1. **You're on the branch you want to test.** The copilot harness is an
optional extra — install it (without disturbing other extras) with
`uv sync --frozen --extra dev --extra copilot`. NB: a bare
`uv run --frozen --extra dev` re-syncs the venv and **prunes** the copilot
SDK; for live testing call `.venv/bin/omni` / `.venv/bin/python` directly and
avoid `uv run` mid-session.
2. **The SDK is installed:**
`.venv/bin/python -c "import copilot; print(copilot.__file__)"`.
3. **A GitHub token with Copilot access is configured.** Copilot needs a
fine-grained PAT with the "Copilot Requests" permission, or an OAuth token
from the GitHub CLI / Copilot CLI app (classic `ghp_` PATs are rejected).
Verify (booleans only — never print the token):
```b