repair

Repair

Re-run every cc-suite setup script in sequence without prompts. All scripts are idempotent — correct artifacts are left alone, missing or broken ones are recreated.

When to Use

• /cc-suite:diagnose found issues and its auto-fix did not resolve them
• The cc-suite layer is in an inconsistent state (e.g. after a manual edit gone wrong)
• After reinstalling cc-suite to a project, to restore all artifacts at once

If repair still leaves issues, the next step is /cc-suite:init in a Claude Code session (full interactive re-initialization).

Workflow

Step 1: Bridge init

bash "${CLAUDE_PLUGIN_ROOT}/scripts/init.sh"

Creates AGENTS.md, CLAUDE.md, GEMINI.md, .codex/config.toml, scaffold directories, and the .gitignore block. Skips each artifact if it is already in place.

Step 2: Expose skills

bash "${CLAUDE_PLUGIN_ROOT}/scripts/bridge_skills.sh"

Links plugin skills into .claude/skills/cc-suite/ and ensures .agents/skills → ../.claude/skills.

Step 3: Register codex-cli MCP server

bash "${CLAUDE_PLUGIN_ROOT}/scripts/mcp_codex.sh"

Adds codex-cli to .mcp.json so Claude can invoke Codex as a tool.

Step 4: Register claude-code MCP server

bash "${CLAUDE_PLUGIN_ROOT}/scripts/mcp_claude.sh"

Adds claude-code (claude-octopus) to .codex/config.toml so Codex can invoke Claude as a tool.

Step 5: Mirror MCP servers

bash "${CLAUDE_PLUGIN_ROOT}/scripts/bridge_mcp.sh"

Copies additional MCP servers from .mcp.json into .codex/config.toml.

Step 6: Bridge hooks

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/bridge_hooks.py"

Mirrors .claude/settings.json hooks into .codex/hooks.json. Skips gracefully if nothing to bridge.

Step 7: Status check

bash "${CLAUDE_PLUGIN_ROOT}/scripts/status.sh"

Show the full status output. Then report:

• All green: "Repair complete — cc-suite is healthy."
• Issues remain: list remaining · and ! items. Distinguish:
  • Items fixable only interactively (e.g. AGENTS.md missing when a non-importable CLAUDE.md exists): "Run /cc-suite:init in a Claude Code session."
  • Items requiring manual action (Codex trust prompt, Codex CLI not installed): give the exact manual step.