← Documentation
Codex CLI

Install Sprintra in Codex CLI

One command adds Sprintra to your Codex setup. Your agent gets project briefing, decision history, and SDLC traceability on every session.

One-command install
npx @sprintra/cli@latest plugin install \
  --ide=codex \
  --project=<your-project-id>

Run from your project root. This writes the Sprintra MCP entry to ~/.codex/config.toml and creates an AGENTS.md project rule that tells Codex to load context at session start.

1. Set your API token

Codex reads the token from the SPRINTRA_TOKEN environment variable. Get yours from app.sprintra.io → account settings → API tokens.

export SPRINTRA_TOKEN="vp_your_token_here"

Add this to your ~/.zshrc, ~/.bashrc, or shell profile so it persists across sessions.

2. Verify the connection

codex mcp list

Expected output:

Name      Url                              Bearer Token Env Var  Status   Auth
sprintra  https://api.sprintra.io/api/mcp  SPRINTRA_TOKEN        enabled  Bearer token

3. Test it in Codex

Open Codex in your project root:

codex

Ask the agent something like:

"What's the latest on this project?"

The agent should call sprintra.ai(method: "generate_briefing") and return a rich briefing with active features, recent decisions, last session digest, top pending stories, and recent commits.

What you get

  • Project briefing on demand — recent decisions with rationale, where you left off, top pending stories, blocking questions
  • 21 MCP tools — stories, features, decisions, sprints, releases, notes, search, work_sessions, and more
  • Persistent memory across sessions — every Codex session starts with full context, no manual summarizing
  • Decision tracking — agents can record architectural decisions with the rationale, surfaced in future sessions
  • Cross-IDE continuity — switch between Codex, Claude Code, and Cursor on the same project; the briefing follows you

Common issues

"Environment variable SPRINTRA_TOKEN for MCP server 'sprintra' is not set"

Your token isn't exported in the shell where you started Codex. Run echo $SPRINTRA_TOKEN to confirm. If empty, re-run the export step and add it to your shell profile so it persists.

"project_id is required"

The agent didn't pass project_id on its MCP call. Check AGENTS.md in your project root — it should have a 🔑 Project ID (REQUIRED) block with your project ID. If missing, re-run npx @sprintra/cli plugin install --ide=codex --project=<id>.

"MCP startup incomplete (failed: sprintra)"

Either the token isn't set, or your network is blocking api.sprintra.io. Test connectivity: curl https://api.sprintra.io/api/health should return {"status":"ok"}.

Briefing returns less detail than expected

The briefing is personalized — “recent asks” and “last conversation” sections only appear when there's recent activity in your project. The first session in a new project will surface only the universal sections (top stories, decisions, notes).

Need an account?

Sprintra Cloud is free to start. Sign up, create a project, and copy your project ID into the install command above.

Sign up free

Using a different AI tool?

Claude CodeCursorAntigravityGemini CLI