FactIQ
Back to Docs

Add FactIQ to Codex CLI

Requires the Codex CLI·FactIQ is free to start

Set up

This installs FactIQ for the Codex CLI. If you already installed FactIQ in the ChatGPT desktop app, Codex in the app is covered — only the CLI needs this separate terminal install.

  1. 1

    Add the FactIQ marketplace

    codex plugin marketplace add defog-ai/factiq-plugin
  2. 2

    Add the plugin

    codex plugin add factiq@factiq
  3. 3

    Sign in to FactIQ

    Finish the browser sign-in. Email, Google, and passkey all work.

    codex mcp login factiq
  4. 4

    Start a new thread

    The connection applies to new Codex threads, not ones already running.

Try it

Ask a data question normally in a new thread — Codex picks up the FactIQ tools automatically.

  • For Nvidia’s latest covered earnings call, identify the most decision-relevant management claims and Q&A pressure points. For claims, return verbatim quotes with speaker/role, section, call date, fiscal period, and citations. For pressure points, label the returned quote as a composite analyst-ask/management-response excerpt and include the analyst firm when available, specific ask, response quality, any refused number, call date, fiscal period, and citation; do not infer unavailable speaker names or roles. Report coverage gaps and cap hits.
  • Test Walmart management’s consumer trade-down claims against US retail sales, CPI, real earnings, and consumer-credit data. Separate source evidence from inference and say what would falsify the conclusion.
  • Chart US unemployment and labor-force participation since 2000. State the series IDs, frequency, seasonal adjustment, observation range, and sources.

For coverage checks, batching, evidence rules, and stronger prompt patterns, read how to get better results.

Troubleshooting

Marketplace add fails
Confirm the marketplace name is exactly defog-ai/factiq-plugin and that your network allows Codex to reach GitHub.
Login command fails
Make sure the plugin installed successfully first, then re-run codex mcp login factiq.
OAuth gets stuck
Sign in to FactIQ in the same browser, then re-run codex mcp login factiq.
Tools missing in thread
Start a fresh Codex thread after logging in. To remove the plugin later, run codex plugin remove factiq.