Skip to main content
Codex CLI is OpenAI’s terminal-based coding agent. Give it a system prompt that includes Spine’s API pattern and it will delegate research-heavy tasks to Spine.

​
Install

Download the system-prompt snippet:

Download system prompt

spine.codex.md — append to your Codex system prompt or project instructions
Then append it to your Codex system instructions, or paste it into your project’s AGENTS.md.

​
Set your API key

Create a key at platform.getspine.ai/keys.

​
What it does

The system prompt teaches Codex:
  1. When to call Spine — multi-source research, deliverable generation, competitive analyses
  2. The two-step pattern — POST /v1/run → poll GET /v1/run/{run_id}
  3. How to pick a template based on the deliverable type
  4. How to present results — final_output text + artifact download links

​
Non-interactive / CI usage

Three one-time setup steps are required for unattended Codex invocation:
Then invoke:
  • --skip-git-repo-check is required when running outside a git repo; without it Codex refuses with Not inside a trusted directory.
  • --full-auto is tempting for automation but its sandbox blocks network — Codex cannot reach api.getspine.ai under that preset. Use --dangerously-bypass-approvals-and-sandbox or a custom sandbox policy that allows outbound HTTPS.
  • < /dev/null closes stdin; without it codex exec blocks waiting for additional input even when the prompt is passed as an argument.

​
Example

For long-running production workflows, register a webhook instead of polling — see Webhooks. Poll loops inside codex exec can exceed the turn budget for runs longer than 5–10 minutes.