> ## Documentation Index
> Fetch the complete documentation index at: https://summation-676748f5-docs-api-and-integrations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex Plugin

> Bring Addison into OpenAI Codex — the CLI and the Codex app. Ask data questions, generate and validate reports, explore your catalog, with one browser sign-in.

The Addison plugin puts Summation's AI data analyst inside OpenAI Codex. It's built on Codex's plugin marketplace and shares the same skills as the [Claude plugin](/integrations/claude-plugin), so the experience matches: install from a marketplace, sign in once in your browser, then ask data questions in plain English. No API keys, no secrets pasted into chat — everything runs as **you**, against **your** Summation workspace.

Skills are invoked with Codex's `$` mentions (for example `$addison-start`), or picked up automatically when your request matches.

## Installing Addison for Codex CLI

<Steps>
  <Step title="Add the Summation marketplace">
    ```bash theme={null}
    codex plugin marketplace add summationai/addison-plugin
    ```
  </Step>

  <Step title="Install the plugin">
    From the `/plugins` menu inside Codex, or the command line:

    ```bash theme={null}
    codex plugin install addison
    ```
  </Step>

  <Step title="Sign in">
    ```text theme={null}
    $addison-signin
    ```

    Addison shows a sign-in link and a short verification code:

    ```text theme={null}
    Open this link and approve to connect Codex to Summation — it expires in 10 minutes.
    https://app.summation.com/device?code=WXYZ-1234
    Verification code: WXYZ-1234
    ```

    Open the link, approve in your browser, and you're connected. Sign-in also registers the hosted [Summation MCP server](/integrations/mcp-server) in `~/.codex/config.toml` for you — start a new Codex thread (or restart Codex) to load the tools.
  </Step>

  <Step title="Take the tour">
    ```text theme={null}
    $addison-start
    ```

    A guided first run: a map of your connected data, an introduction to Addison, and your first report.
  </Step>
</Steps>

### Commands

| Command             | What it does                                             |
| ------------------- | -------------------------------------------------------- |
| `$addison-start`    | Guided onboarding — data map and first report            |
| `$addison-report`   | Generate a report and export it (PDF, DOCX, or Markdown) |
| `$addison-query`    | Run a read-only query and see results as a table         |
| `$addison-catalog`  | Search your tables, views, and schemas                   |
| `$addison-validate` | Fact-check a report against its sources before sharing   |
| `$addison-signout`  | Disconnect and remove the stored credential              |

You don't need commands for most work — just ask data questions in plain English and Addison picks them up.

## Installing Addison for the Codex app

The Codex app adds a plugin marketplace through a dialog rather than the command line. The steps are the same underneath — add the marketplace, install Addison, sign in.

<Steps>
  <Step title="Open Add plugin marketplace">
    In the Codex app, open the plugins area and choose **Add plugin marketplace**.

    <Warning>
      Screenshot needed: Codex app plugins area with the "Add plugin marketplace" button
    </Warning>
  </Step>

  <Step title="Point it at the Summation repository">
    Fill in the dialog:

    | Field            | Value                               |
    | ---------------- | ----------------------------------- |
    | **Source**       | `summationai/addison-plugin`        |
    | **Git ref**      | `main`                              |
    | **Sparse paths** | *(leave empty for a full checkout)* |

    Then choose **Add marketplace**.

    <Warning>
      Screenshot needed: "Add plugin marketplace" dialog filled in with the Source and Git ref above
    </Warning>
  </Step>

  <Step title="Install Addison">
    Open the Summation marketplace and install **Addison**.

    <Warning>
      Screenshot needed: Summation marketplace listing showing the Addison plugin with an Install button
    </Warning>
  </Step>

  <Step title="Sign in">
    Start Addison and type `$addison-start` (or `$addison-signin`). Approve the sign-in link in your browser, and Addison connects and shows a map of your data.

    <Warning>
      Screenshot needed: Codex app chat showing the Addison sign-in link and verification code
    </Warning>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;Not signed in to Summation. Run $addison-signin to connect.&#x22;">
    Your session expired or was never completed. Run `$addison-signin` again — it takes seconds.
  </Accordion>

  <Accordion title="The Summation tools don't appear after signing in">
    Codex loads MCP tools when a thread starts. Start a new Codex thread, or restart Codex, after `$addison-signin`.
  </Accordion>

  <Accordion title="A report or query is taking a while">
    Report generation and validation are thorough and can take a minute or two. Addison tells you it's working — this is normal, not a hang.
  </Accordion>

  <Accordion title="I need automation or a non-production environment">
    The plugin is production, browser-sign-in only — the right default for almost everyone. For machine-to-machine access, see the [Public API](/integrations/public-api) or the [CLI](/integrations/cli), or contact your Summation representative.
  </Accordion>
</AccordionGroup>