Skip to content
Docs

Codex

Set Codex up with one line in your terminal: it installs the CLI, teaches Codex Basemodo and signs you in.

Set up

In your terminal, on macOS and Linux:

Terminal window
curl -fsSL https://basemodo.com/install | sh

On Windows, in PowerShell:

Terminal window
irm https://basemodo.com/install.ps1 | iex

It installs the basemodo command, then runs basemodo setup: it asks whether your agents should know Basemodo in every project (press Enter) or only in the folder your terminal is in, finds the agents on your computer and writes Basemodo's Skills where each reads them, then opens your browser to sign you in. Running the line again updates the CLI and the Skills.

Codex reads the Skills from ~/.agents/skills, or from the project's .agents/skills when you chose this project only. Start a new Codex session and ask it, for example: "Deploy this folder to Basemodo and give me the link." It runs the CLI and deploys the folder it works in, with no GitHub repository needed.

Other ways

Use one way in Codex: the install line above, or one of these. Each gives it every command of Basemodo (the Plugin through the Remote MCP), so with two it sees every command twice (one way per client).

The Plugin

Basemodo's Skills and its Remote MCP in one install, without the CLI, from basemodocom/agent:

Terminal window
codex plugin marketplace add basemodocom/agent
codex plugin add basemodo@basemodo

Then sign in to its Remote MCP with codex mcp login basemodo, as below.

The Remote MCP

Terminal window
codex mcp add basemodo --url https://mcp.basemodo.com
codex mcp login basemodo

The first command adds Basemodo. Then sign in, with the second: it opens your browser on basemodo.com, which asks you to approve Codex. Approve it, and Codex acts as you through its Agent Grant. Codex registers itself with Basemodo, so there is no client ID to pass. In a session, /mcp lists the servers Codex is connected to. Its deploy takes a GitHub repository, not a folder.

The Codex CLI, its IDE extension and the ChatGPT desktop app share this configuration, so one setup serves all three.

The local MCP

The same tools on your computer, basemodo mcp. With basemodo installed (curl -fsSL https://basemodo.com/install | sh on macOS and Linux, irm https://basemodo.com/install.ps1 | iex in Windows' PowerShell) and signed in with basemodo login:

Terminal window
codex mcp add basemodo -- basemodo mcp

What it needs

Codex signed in with any ChatGPT plan (Free and Go included), or with an OpenAI API key.