Agent Center

Economico for Codex

Codex is OpenAI's coding agent for the terminal. It's shell-driven, so it connects to Economico through the @economico/cli package rather than MCP. Install the skill pack or the CLI, sign in once, and Codex keeps real, GAAP-shaped books while you build.

What Codex is

Codex is OpenAI's command-line coding agent — an open-source tool that runs in your terminal, reads and writes files, and executes shell commands. It's CLI-focused rather than an MCP host, so the cleanest way to give it your books is the @economico/cli package, which Codex calls like any other shell command.

Connect Economico — skill pack (recommended)

Install the open cfo-skills pack. It drops into the skill directories Codex already scans (~/.agents/skills/), so Codex discovers the setup and CFO playbooks automatically:

Install the CFO skill pack

npx skills add economico/cfo-skills

Then, in Codex, run the setup and sign in:

Connect & authenticate

Run the setup-economico skill to connect and authenticate my books.

Connect Economico — CLI directly

Or install the CLI yourself and log in. The browser opens once; tokens persist and refresh automatically:

Install & log in

npm install -g @economico/cli
economico login

On a sandboxed or CI runner with no global state, run it ephemerally:

Ephemeral (npx)

npx -y @economico/cli@latest login

Or just hand Codex the skill and let it set itself up:

Set up Economico per https://economi.co/skill.md

What to run once connected

Ask in plain language — Codex builds the CLI calls, posts the double-entry, and reads the result back. Copy one to try:

Invoice a customer

Create and send an invoice to Acme for $4,000 for March consulting, NET-30.

Book an expense you already paid

Record the $90 Vercel receipt from my email against hosting.

Track startup credits

How much of our AWS and OpenAI credits are left, and when do they expire?

Close the month

Summarize this month's invoiced, paid, outstanding, and recognized revenue.

Make a decision

What's my runway, and model a 20% price increase as a what-if scenario.

Frequently asked questions

Why doesn't Codex use the MCP endpoint?

Codex is CLI-focused, not an MCP host. The @economico/cli package exposes the exact same money-loop verbs and JSON shapes as the MCP server, so nothing is lost — it's the same books, reached over the shell.

What do I need installed?

Node 20 or newer for @economico/cli. It runs on Linux, macOS, and Windows. The npx skills add path installs the skills without a global CLI.

Can Codex run unattended in CI?

Yes. Use --no-browser at login on headless hosts, or register a confidential OAuth client and authenticate with private_key_jwt for fully unattended runs — see skill.md.