> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoista.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Add Hoista to OpenAI Codex, in the CLI or the IDE extension.

Codex starts Hoista's MCP server itself, over stdio. The CLI and the IDE extension share the same settings, so adding it once covers both. You need Hoista on this computer: run `hoist doctor` to check.

## Add Hoista

```bash theme={null}
codex mcp add hoista -- "$(command -v hoist)" mcp
```

Or add it to `~/.codex/config.toml` yourself:

```toml theme={null}
[mcp_servers.hoista]
command = "/Users/you/.local/bin/hoist"
args = ["mcp"]
```

Use the path `command -v hoist` prints. A full path matters for the IDE extension, which doesn't always see the same `PATH` as your terminal.

## Approve it in Hoista

When Codex starts Hoista, Hoista opens a page in your browser with a code. Check the code matches the one Codex shows, choose **What it may do** and allow it. If the page doesn't open, allow it in **Agents** in the desktop app, or from a terminal:

```bash theme={null}
hoist agents requests
hoist agents allow
```

Start with **View only** and widen it later in [Agent permissions](https://docs.hoista.dev/agents/permissions.md).

## Add Hoista's skills

Hoista's skills teach Codex how to use it well: where to start, how to connect providers and import projects, and how to deploy, fix and manage them.

```bash theme={null}
hoist skills install
```

## Check it works

Ask Codex: "What projects do I have on Hoista?" It should list your projects. If it doesn't, see [If it doesn't connect](#if-it-doesnt-connect).

## Hoista on a remote

Codex talks to Hoista on this computer. While a [remote](https://docs.hoista.dev/guides/remote.md) is selected (`hoist remote use NAME`), `hoist mcp` won't start. To use the remote, add it to Codex as an HTTP MCP server at its own address: `hoist mcp config` prints the remote's `/mcp` URL. Codex then signs in with OAuth.

## If it doesn't connect

* Run `codex mcp list` to check Hoista is listed, and `hoist doctor` to check Hoista itself.
* **To remove it:** `codex mcp remove hoista`, then revoke the agent in **Agents** or with `hoist agents revoke`.

## Related

> [card] [Agent permissions](https://docs.hoista.dev/agents/permissions.md)
>
> Change or narrow what an agent can do.

> [card] [Approvals](https://docs.hoista.dev/security/approvals.md)
>
> What Hoista asks you before an agent acts.

> [card] [Prompts](https://docs.hoista.dev/agents/prompts.md)
>
> Prompts to start with.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.