Skip to content

docs: reference pages still enumerate only codex/claude; coven run --add-dir undocumented #458

Description

@BunsDev

Follow-up sweep from the UX pass (#446#450; flagged in the bodies of merged PRs #453/#454/#457): a handful of reference/topic docs still enumerate only Codex and Claude Code where GitHub Copilot CLI is a shipped built-in harness, and coven run --add-dir is undocumented.

Verified stale spots (checked against crates/coven-cli/src/harness.rs built_in_harness_specs and main.rs):

  • docs/reference/cli.md:98 — "Current harness ids: codex, claude."
  • docs/reference/cli-run.md:15 — "a configured harness id such as codex or claude"; also no --add-dir row in the flags table (flag exists, main.rs:234-238).
  • docs/reference/cli-doctor.md:85 — "install hints for Codex and Claude Code" block omits the Copilot hint that doctor actually prints (harness.rs copilot spec install_hint).
  • docs/reference/harness-adapters.md:2 — front-matter summary "The adapter shape Codex and Claude Code use today."
  • docs/concepts/features.md:14 — "Codex and Claude Code today; Hermes, Aider, Gemini, Cline tomorrow."
  • docs/start/showcase.md:21 — card "Codex and Claude Code today".
  • docs/ROADMAP.md Shipped list (lines ~90/91/98) — built-in adapters, coven run codex|claude, and first-run recovery hints all predate Copilot support.

Deliberately NOT touched: docs/PRODUCT-SPEC.md and docs/MVP-PLAN.md (historical/spec voice), docs/OPERATIONAL-MODEL.md:97 (the OpenClaw plugin really does map only codex/claude ids — verified in packages/openclaw-coven), docs/es + docs/ru.

Gates: python scripts/check-secrets.py, git diff --check, node --test scripts/onboarding-docs-test.mjs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions