docs → tools → codex

Frenchie in Codex (Desktop, CLI, IDE)

@frenchie, /frenchie, or natural language — all three work.

Install

From your project root:

npx @lab94/frenchie install --agent codex --api-key fr_your_key_here

Need help picking an agent? See the invocation matrix.

Invoke

Primary pattern:

/frenchie TOR.pdf

Also works:

@frenchie ocr TOR.pdf
OCR TOR.pdf with Frenchie

Codex Desktop, Codex CLI, and the Codex IDE extension all work with the same three invocation styles. In CLI and IDE, /skills lists skills and lets you pick Frenchie from a menu.

Example

You:

/frenchie TOR.pdf

Agent:

Codex calls ocr_to_markdown with the file path, the stdio server writes the result, Codex reads the file if needed.

Known gotchas

"Auth unsupported" label in the MCP panel

Codex Desktop shows frenchie — Auth unsupported — Enabled in the MCP settings. It looks like an error but isn't — Codex has no UI control for stdio env-var auth, so it labels every env-auth server that way. The server still launches with FRENCHIE_API_KEY in its env. Nothing to fix.

Cross-reference: /docs/troubleshooting#codex-auth-unsupported

Main Frenchie docs — MCP tools, credits, rate limits, full API
All agent guides — the full invocation matrix
Troubleshooting — symptom-first fixes for every error we've seen
Migration guide — upgrading from 0.1.x, 0.2.x, 0.3.0, or 0.3.1