-
Notifications
You must be signed in to change notification settings - Fork 0
User Manual
Harness of AI is a meta-agent orchestrator for VS Code: one sidebar for Copilot, Claude, Cursor, Devin, and Kiro, with shared file context and Spec-Driven Development (SDD).
In the app:
Ctrl+Shift+P→ Harness of AI: Open User Manual (dedicated editor tab).
- Download
harness-vscode-*.vsixfrom Releases. -
Ctrl+Shift+P→ Extensions: Install from VSIX... - Developer: Reload Window
- Click the Harness of AI icon (fox) in the Activity Bar.
On first configuration, the welcome screen summarizes what you get in one place:
| Feature | Description |
|---|---|
| Unified chat | Copilot, Claude, Devin, Cursor, and Kiro in the same panel |
| Shared context | Right-click → Add to Harness of AI Context |
| Specs (SDD) | Skills, Tools, and Workflows in .harness/specs/
|
| MCP | External tool servers |
Click Get started → to configure agents, or Skip and configure later. The setup wizard ends with the User Manual step before you finish.
By default Harness attaches: manual context chips, open editor tabs, and the workspace folder (see settings harness.context.includeOpenEditors and harness.context.includeWorkspaceRoot).
- Explorer or editor → right-click → Add to Harness of AI Context
- The same context is sent to whichever provider you pick next
- + New chat / Clear context / Clear Chat & Context
Providers: Auto, Copilot, Claude, Cursor, Devin, Kiro.
Modes: Ask | Agent | Spec+Agent.
| Mode | Copilot | Cursor |
|---|---|---|
| Ask | Chat | Cursor Cloud (remote) |
| Agent | Local read/write in workspace | Local tools (same as Copilot Agent; needs Copilot token) |
| Spec+Agent | Local + specs | Local + specs |
Agent mode uses tools: read_file, write_file, list_files, search_in_files, run_git, run_gh. Files change on disk in your project. Cursor Cloud does not edit the IDE tree directly.
For GitHub CLI: configure gh auth login; Agent mode can call run_gh.
Open Harness of AI: Open Configuration → Agents tab. Each card shows the provider name, a short description, and Not configured until you add credentials.
Use Configure on each agent, paste the API key or token, then Test Connection. Tokens are stored in VS Code Secret Storage (never in plain-text settings).
| Agent | Typical use |
|---|---|
| GitHub Copilot | Code review and generation via GitHub |
| Claude Code | Large context and complex reasoning |
| Devin | Autonomous engineering tasks |
| Cursor AI | Cloud Agents API (api.cursor.com) |
| Kiro (AI-DLC) | Kiro CLI + steering rules in .kiro/steering/
|
In configuration, open the API Servers tab:
- Built-in agents — default endpoints for Copilot, Devin, and Cursor (read-only rows).
- Custom API servers — add OpenAI-compatible backends with + Add API server (name, base URL, optional model).
| Tab | Purpose |
|---|---|
| MCP | Connect Model Context Protocol servers (stdio or HTTP) |
| Workspace | Default workspace path, default agent, prompt optimization |
| Spending | Token and request usage per provider |
| Command | Purpose |
|---|---|
Harness of AI: Open User Manual |
This guide (dedicated tab) |
Harness of AI: Open Configuration |
Agents, MCP, workspace, spending |
Harness of AI: Initialize Workspace |
Create .harness/
|
Harness of AI: Check getGoat |
Agent diagnostics |
Repository: github.com/nbsjunior/harness
Getting started
Using Todd of AIDLC
Agents
Advanced
Help