Codex CLI

Connect genart.dev to Codex CLI (OpenAI's terminal agent) using mcp-remote as a stdio-to-HTTP bridge.

Prerequisites

• Codex CLI installed
• Node.js (for npx mcp-remote)
• An email address for authentication

Setup

1. Add the remote MCP server

Add the genart MCP server to ~/.codex/config.toml:

[mcp_servers.genart]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.genart.dev/mcp", "--transport", "streamable-http"]

Codex CLI doesn't support Streamable HTTP natively, so mcp-remote bridges the connection as a stdio subprocess.

2. Authenticate

On first tool use, the server will send a passcode to your email. Enter it when prompted.

3. Start creating

Create a p5.js sketch of concentric rotating rings

Tips

• Tools are prefixed with genart__ (e.g. genart__create_workspace)
• All 33 MCP tools are available — see MCP Tools
• Add project-specific instructions in AGENTS.md (equivalent of CLAUDE.md)
• TOML arrays use bracket syntax: args = ["-y", "mcp-remote", ...]

Desktop app auto-config

If you're using the Desktop App, it can configure Codex CLI automatically. The desktop app writes the genart entry to ~/.codex/config.toml on startup and removes it on quit. See CLI Agent Integration for details.