From a8d7124cdefd88fe3a0347285ddf57e45aa6259f Mon Sep 17 00:00:00 2001 From: Val Alexander <68980965+BunsDev@users.noreply.github.com> Date: Tue, 21 Jul 2026 21:00:24 -0500 Subject: [PATCH] docs: list copilot in remaining harness enumerations and document --add-dir Sweep the reference/topic docs that still claimed only Codex and Claude Code where GitHub Copilot CLI is a shipped built-in harness, and add the missing --add-dir row to the coven run reference. Follow-up flagged in the bodies of merged PRs #453/#454/#457. Closes #458 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: Val Alexander <68980965+BunsDev@users.noreply.github.com> --- docs/ROADMAP.md | 6 +++--- docs/concepts/features.md | 2 +- docs/reference/cli-doctor.md | 6 ++++-- docs/reference/cli-run.md | 3 ++- docs/reference/cli.md | 2 +- docs/reference/harness-adapters.md | 2 +- docs/start/showcase.md | 4 ++-- 7 files changed, 14 insertions(+), 11 deletions(-) diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 4691b61a..71a88792 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -87,15 +87,15 @@ Shipped: - `coven doctor` setup checks. - Local daemon lifecycle: `coven daemon start/status/restart/stop`. - Project-root and cwd boundary guard. -- Built-in Codex and Claude Code harness adapters. -- PTY-backed `coven run codex|claude ` sessions. +- Built-in Codex, Claude Code, and GitHub Copilot CLI harness adapters. +- PTY-backed `coven run codex|claude|copilot ` sessions. - SQLite-backed session metadata and event log. - Session browser and rituals: **Rejoin**, **View Log**, **Summon**, **Archive**, **Sacrifice**. - Scriptable and human session output: `coven sessions`, `--plain`, and `--all`. - Local HTTP-over-Unix-socket API for CastCodes and advanced local clients. - Versioned `coven.daemon.v1` API contract with named apiVersion, machine-readable capabilities, structured errors, and monotonic event cursors. See [`docs/API-CONTRACT.md`](/API-CONTRACT). - Compatibility tests for the external OpenClaw bridge against versioned daemon responses. -- First-run recovery hints for missing Codex or Claude Code CLIs. +- First-run recovery hints for missing Codex, Claude Code, or GitHub Copilot CLIs. - Real CLI smoke coverage for daemon restart, attach replay, kill, archive, summon, and sacrifice flows. - Install verification and release wiring for macOS, Linux x64, and Windows x64 npm package paths. - Published npm wrapper packages: diff --git a/docs/concepts/features.md b/docs/concepts/features.md index 1ed3195b..a3df9bc3 100644 --- a/docs/concepts/features.md +++ b/docs/concepts/features.md @@ -11,7 +11,7 @@ description: "Feature reference for the Coven runtime: project-rooted launches, Every session pins a canonical project root. Cwd must canonicalize inside that root. - Codex and Claude Code today; Hermes, Aider, Gemini, Cline tomorrow. + Codex, Claude Code, and GitHub Copilot CLI today; Hermes, Aider, Gemini, Cline tomorrow. Output, exit, and metadata events stored in SQLite for replay. diff --git a/docs/reference/cli-doctor.md b/docs/reference/cli-doctor.md index ad9646d8..846d254a 100644 --- a/docs/reference/cli-doctor.md +++ b/docs/reference/cli-doctor.md @@ -81,14 +81,16 @@ coven run claude "explain this repo in 5 bullets" ## Missing harness output -When neither supported harness is visible, `doctor` prints install hints for -Codex and Claude Code: +When no supported harness is visible, `doctor` prints a per-harness install +hint. For Codex, Claude Code, and GitHub Copilot CLI those hints boil down to: ```sh npm install -g @openai/codex codex login npm install -g @anthropic-ai/claude-code claude doctor +npm install -g @github/copilot +copilot login coven doctor ``` diff --git a/docs/reference/cli-run.md b/docs/reference/cli-run.md index 2199ab69..dd19084a 100644 --- a/docs/reference/cli-run.md +++ b/docs/reference/cli-run.md @@ -12,13 +12,14 @@ description: "Reference for coven run: one-shot harness execution that spawns a coven run [flags] ``` -`` is a configured harness id such as `codex` or `claude`. +`` is a configured harness id such as `codex`, `claude`, or `copilot`. ## Common Flags | Flag | Behavior | |---|---| | `--cwd ` | Launch from a directory inside the resolved project root. | +| `--add-dir ` | Grant the harness access to an additional directory beyond its cwd; repeat the flag for multiple directories. Maps to each harness's native trust flag (`--add-dir` for codex, claude, copilot, and coven-code). Harnesses with no add-dir mechanism warn and continue. | | `--title ` | Store a readable session title. | | `--model ` | Forward a model override to harnesses that declare model support. Namespaced ids such as `anthropic/claude-sonnet-4` are forwarded to the harness as the bare model id. | | `--think` | Request deeper reasoning. Claude maps this to `--effort high`; unsupported harnesses warn and continue. | diff --git a/docs/reference/cli.md b/docs/reference/cli.md index 61d952b3..74f242d6 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -95,7 +95,7 @@ flowchart TB | `coven doctor` | Check local setup; exits 1 when a blocking problem is found. `--json` emits a `{ ok, blocking, checks, nextSteps }` envelope. | | `coven status` | Ecosystem overview: daemon, sessions, familiars, skills, research, hub. Alias: `coven overview`. | | `coven daemon start/status/restart/stop` | Manage the local daemon. | -| `coven run ` | Launch a project-scoped harness session. Current harness ids: `codex`, `claude`. | +| `coven run ` | Launch a project-scoped harness session. Current harness ids: `codex`, `claude`, `copilot`. | | `coven sessions` | Open the session browser; supports `--plain`, `--json`, `--all`, and `--manage`. | | `coven sessions search ` | Full-text search recorded event payloads. | | `coven sessions show/events/log ` | Inspect one session without attaching; see [cli-observe](cli-observe.md). | diff --git a/docs/reference/harness-adapters.md b/docs/reference/harness-adapters.md index c7101032..109f9e86 100644 --- a/docs/reference/harness-adapters.md +++ b/docs/reference/harness-adapters.md @@ -1,5 +1,5 @@ --- -summary: "The adapter shape Codex and Claude Code use today." +summary: "The adapter shape Codex, Claude Code, and GitHub Copilot CLI use today." read_when: - Looking up adapter expectations title: "Harness adapters" diff --git a/docs/start/showcase.md b/docs/start/showcase.md index eb9e8120..df06b98b 100644 --- a/docs/start/showcase.md +++ b/docs/start/showcase.md @@ -18,8 +18,8 @@ description: "Showcase landing for Coven: a local-first runtime that supervises ## Highlights - - Two supported harnesses, more on the way through the adapter spec. + + Three supported harnesses, more on the way through the adapter spec. Session shape that CastCodes and advanced clients can replay.