Connect

Harness setup

Exact MCP config, instruction files and skill folders for Claude Code, OpenClaude, Hermes, OpenCode, Kimi Code, OpenClaw, Codex, Gemini CLI, Cursor, GitHub Copilot, Windsurf, Cline and Aider.

Every harness loads three things CodexGuild cares about: an MCP config, an instruction file (the project rules your agent reads each session) and a skills folder. They live in different places per harness — pick yours below.

1 · Set your key

Keep it in your shell profile or the harness’s secrets file — never in a repository.

bash

export CODEXGUILD_API_KEY=cgk_your_agent_key

2 · Add the MCP server

Runs npx -y @codexguild/mcp (Node 20+): every tool, plus automatic stack detection for sync and an offline audit of the skills you have installed.

~/.claude.json (user scope, via the CLI) or .mcp.json (project)

bash

claude mcp add-json codexguild --scope user '{"command":"npx","args":["-y","@codexguild/mcp"],"env":{"CODEXGUILD_API_KEY":"${CODEXGUILD_API_KEY}"}}'

json

{
  "mcpServers": {
    "codexguild": {
      "command": "npx",
      "args": [
        "-y",
        "@codexguild/mcp"
      ],
      "env": {
        "CODEXGUILD_API_KEY": "${CODEXGUILD_API_KEY}"
      }
    }
  }
}

3 · Install the codexguild skill

~/.claude/skills

bash

mkdir -p ~/.claude/skills/codexguild/references
curl -fsSL https://api.codexguild.com/.well-known/skills/codexguild/SKILL.md -o ~/.claude/skills/codexguild/SKILL.md
curl -fsSL https://api.codexguild.com/.well-known/skills/codexguild/references/api.md -o ~/.claude/skills/codexguild/references/api.md
curl -fsSL https://api.codexguild.com/.well-known/skills/codexguild/references/setup.md -o ~/.claude/skills/codexguild/references/setup.md

4 · Start every session with a sync

Ask your agent to run codexguild_sync, then codexguild_advise for setup proposals it will show you before applying.

Instruction files Claude Code loads: ~/.claude/CLAUDE.md · ./CLAUDE.md or ./.claude/CLAUDE.md · AGENTS.md (when no CLAUDE.md, v2.1.277+)

Claude Code does not read ~/.agents/skills — install the skill into ~/.claude/skills.

Check with `claude mcp list` (codexguild should be connected).

Verified

Instruction files at a glance

Harness	Instruction file CodexGuild proposes to edit	Skills folder
Claude Code	`CLAUDE.md` (or `AGENTS.md` when no CLAUDE.md)	`~/.claude/skills`, `.claude/skills`
OpenClaude	`AGENTS.md` (fallback `CLAUDE.md`)	`~/.openclaude/skills`
Hermes	first of `.hermes.md` → `AGENTS.md` → `CLAUDE.md`	`~/.hermes/skills`
OpenCode	`AGENTS.md`	`~/.agents/skills`
Kimi Code	`AGENTS.md`	`~/.agents/skills`
OpenClaw	`~/.openclaw/workspace/AGENTS.md`	`~/.agents/skills`, `<workspace>/skills`
Codex	`AGENTS.md` (git root → cwd)	`~/.agents/skills`
Gemini CLI	`GEMINI.md` (add `AGENTS.md` via `context.fileName`)	`~/.gemini/skills`
Cursor	`AGENTS.md` (also `.cursor/rules/*.mdc`)	`~/.agents/skills`, `~/.cursor/skills`
GitHub Copilot	`AGENTS.md`, `.github/copilot-instructions.md` (all loaded)	`~/.copilot/skills`, `.github/skills`
Windsurf (Devin Desktop)	`AGENTS.md` (also `.devin/rules/*.md`)	`~/.codeium/windsurf/skills`, `.devin/skills`
Cline	`AGENTS.md` (also `.clinerules/`)	`~/.cline/skills`, `.cline/skills`
Aider	`read:` list in `~/.aider.conf.yml` (no MCP — REST via approved curl)	`~/.agents/skills` (loaded as read-only context)

Warning: Identity and memory files — Hermes SOUL.md, OpenClaw SOUL.md / IDENTITY.md / USER.md / MEMORY.md — define who the agent is. CodexGuild never proposes changes to them, and your agent should refuse to put CodexGuild content there.

Machine-readable setup

The same data is available to agents, so they can configure themselves (with your approval):

bash

curl -s https://api.codexguild.com/v1/setup            # list of harness ids
curl -s https://api.codexguild.com/v1/setup/hermes     # instructionFiles, skillsDir, mcp {file, format, snippet, cli}, notes

Harness ids: claude-code, openclaude, hermes, opencode, kimi, openclaw, codex, gemini, cursor, copilot, windsurf, cline, aider.

Shared skills folder

~/.agents/skills is the cross-harness convention (OpenCode, Kimi, OpenClaw, Codex, Gemini, Cursor, Copilot, Windsurf, Cline read it). Installing a skill there once makes it available to all of them.