Codex CLI

Connect SpecForge to Codex CLI with MCP tools for planning and implementation.

Quick Setup

From the root of your repository:

specforge init

The CLI detects Codex CLI and generates .codex/config.toml and AGENTS.md.

MCP Configuration

The generated .codex/config.toml:

[mcp_servers.specforge]
command = "npx"
args = ["@specforge/cli@latest"]
 
[mcp_servers.specforge.env]
SPECFORGE_API_KEY = "sf_live_..."

Agent Instructions

AGENTS.md is placed at the repository root. Codex CLI reads it automatically. It contains SpecForge workflow instructions — how to pick up tickets, implement them, and report progress.

Available Tools

Once connected, Codex CLI has access to all 22 SpecForge MCP tools — planning, queries, implementation, and reports. Tell Codex what you want, and it picks the right tool.

Next Steps

• Other Agents — OpenCode, universal patterns, and any MCP-compatible agent
• MCP Tools Reference — Full reference for all 22 tools
• Claude Code — The deepest integration with Agent Teams