Home/Setup/Codex

Connect Codex to Spacefast.

Codex can publish the files it is already editing. The plugin is the recommended setup because it installs the Spacefast skill and MCP tools together.

Set it upSee what to make →

What Codex can do.

Publish the working tree
Codex can build, inspect, and publish the current project without an upload handoff.
Operate existing spaces
Use MCP or the CLI for versions, rollback, domains, access, and logs.
Keep project instructions
Add one stable publishing instruction to AGENTS.md so later tasks know the path.

Set it up.

Start with the first option. The alternatives are there for a different runtime or access model.

Add one publishing instruction to AGENTS.md. Plugin, skill, and MCP setup are also available.

Add to AGENTS.md:

Codex fetches the instructions and publishes.

Set up once — plugin, skill, on-device mcp, hosted mcp

  • Plugin — The $spacefast skill plus On-Device MCP in one install.

  • Skill — The publish skill on its own, via the agent-skills installer.

  • On-Device MCP — Paste into ~/.codex/config.toml.

  • Hosted MCP — For Codex cloud and ChatGPT clients that can't run local commands.

Step-by-step guide · Codex setup

Try these recipes.

Open the finished site, read what the recipe asks for, or copy the exact prompt into Codex.

Tools, apps & games · Vite + React

App prototype

A multi-view task app prototype — a draggable kanban board, a sortable list view, and a task detail drawer with subtasks, comments, filters, and search, all saved on your device.

Details and live output →

Personal & creative · HTML5 canvas game

Portfolio

An explorable pixel-art portfolio — walk a little avatar around a cozy room and step up to the desk, bookshelf, poster, and mailbox to reveal projects, an about, a resume, and contact links.

Details and live output →

Data, internal & startup · Vanilla JS

Status page

A public status page for an API product — overall-status banner, per-component 90-day uptime bars, an incident timeline, scheduled maintenance, and a subscribe box.

Details and live output →

Check the connection.

  1. Step 1

    Install the Spacefast plugin or add the MCP server.

  2. Step 2

    Ask Codex to list the Spacefast tools it can use.

  3. Step 3

    Publish the current folder and open the returned live URL.

If it does not connect.

MCP is installed but requests are unauthorized.
Run the Codex MCP login step and complete the browser authorization before retrying.
Codex cannot see local files through hosted MCP.
Use the plugin, on-device MCP, or CLI path when the task needs access to the working tree.

Keep going.