docs: add connect-a-harness guide (guides checkpoint 3)#38
Merged
Conversation
Second catalog entry: choose, install, authenticate, and verify a harness (Codex, Claude Code, Coven Code, Copilot), then run it through Coven. Install hints and unavailable-harness behavior verified against coven-cli harness.rs built-ins and selected_available_harness. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new Guides entry, Connect a Harness, expanding the step-by-step catalog with instructions for selecting, installing, authenticating, verifying, and running a harness (Codex, Claude Code, Coven Code, Copilot) under Coven supervision.
Changes:
- Add a new “Connect a Harness” guide with numbered steps, expected output, and troubleshooting cross-links.
- Register and link the new guide in the Guides nav (
meta.json) and the Guides catalog (index.mdx). - Extend
check-guides-docsto pin the new page, required command mentions, and the provider-auth boundary cross-link.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| scripts/check-guides-docs.mjs | Adds connect-a-harness to required pages, pins additional harness-related mention strings, and enforces a provider-auth link in the new guide. |
| content/docs/guides/meta.json | Registers connect-a-harness in the Guides section page list. |
| content/docs/guides/index.mdx | Updates the catalog table to link to the new guide. |
| content/docs/guides/connect-a-harness.mdx | New step-by-step guide for connecting and validating a harness (install → auth → doctor → run) with troubleshooting and related links. |
This was referenced Jul 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Checkpoint 3 of the guides-section goal, stacked on #37 (which stacks on #34): the Connect a Harness guide — choose, install, authenticate, verify, and run a harness through Coven.
Changes
content/docs/guides/connect-a-harness.mdx— 5 steps covering all four built-in harnesses (codex,claude,coven-code,copilot), provider-auth boundary, doctor verification, and failure-mode footercontent/docs/guides/index.mdx— catalog row linkedcontent/docs/guides/meta.json— page registeredscripts/check-guides-docs.mjs— pins for the new page, engine/adapter/copilot mentions, and the provider-auth cross-linkVerified against source (
../coven@ 2850c53, crates/coven-cli/src/harness.rs)npm install -g @openai/codex/brew install --cask codex,@anthropic-ai/claude-code+claude doctor,coven engine install,npm install -g @github/copilot/brew install --cask copilot-cli+copilot loginselected_available_harness(main.rs:3894): unavailable harness fails fast with the doctor install hintcoven adapter installexternal-adapter path (grok/hermes recipes)Validation
check-guides-docs,english-only,no-leading-h1,mermaid-parse,validate-links(0 errors) ✅npx tsc --noEmit+npx next build✅ —/docs/guides/connect-a-harnessprerendered