A local browser + MCP surface for coding agents. Chat, live canvas, and multi-agent tabs — all running on your machine, orchestrated by any MCP- speaking CLI (Claude Code, codex, gemini, aider, cursor-agent…).
🌐 climax.com.mx — hosted UI · climax.com.mx/app — launch straight into the app (talks to your local backend over CORS)
Real recording: empty state → + agent → Claude Code → agent authors a welcome UI on the canvas.
Watch the full-quality MP4.
One line:
curl -fsSL https://climax.com.mx/install.sh | shOr with pip (pre-release for now — remove --pre once 0.1.0 ships):
pip install --pre python-climaxThe PyPI name is
python-climaxbecause plainclimaxwas already taken. The command and import name are stillclimax.
Then start it:
climax
# → http://127.0.0.1:8011Open the URL. Click + agent in the browser to launch a coding agent — the backend spawns it with an ephemeral MCP config, so nothing to wire up by hand.
| Tool | What it does |
|---|---|
page_set(html) |
Replace the canvas with new HTML. |
page_append(html) |
Append an HTML fragment to the canvas. |
notify(msg, level) |
Corner toast (info · success · warn). |
chat_say(msg) |
Send an assistant bubble to the chat. |
wait(timeout?) |
Block until the user chats or the canvas emits an event. |
snapshot_* |
Save/list/restore/patch canvas snapshots. |
telemetry_recent |
Recent backend events for debugging. |
The canvas iframe can talk back to the agent:
window.parent.postMessage({
type: 'climax.event',
name: 'submit',
data: { /* whatever */ },
}, '*');wait returns {stream:'canvas', name, data, ts} for canvas events and
{stream:'chat', msg} for typed chat. One tool, both surfaces.
Every MCP client identifies itself with an X-Climax-Agent header. The
browser shows one tab per agent — canvas, chat, and pty terminal each.
Click + agent to launch a new one from a preset (see
climax/agents.toml). Bring-your-own preset via ~/.climax/agents.toml.
git clone https://github.com/sheunaluko/climax
cd climax
pip install -e ".[dev]"
climax --host 127.0.0.1 --port 8011Set PYTHON=/path/to/python ./start.sh for the convenience launcher
(kills a stale instance on the port first).
- Iframe is
sandbox="allow-scripts allow-forms allow-popups"— no parent-frame access, no cookies. Safe for LLM-authored HTML. - Backend state is per-agent in-memory; snapshots persist to a local SQLite file for offline reference.
waitraces both queues so agents never miss input on the wrong stream.
MIT — see LICENSE.


