climax

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…).

┌───────────────────────────────────────────────┐
│  https://local.climax.com.mx:8011             │
│  ┌─────────────────────────────────────────┐  │
│  │                                         │  │
│  │      CANVAS  (sandboxed iframe —        │  │
│  │      agent-authored HTML, live)         │  │
│  │                                         │  │
│  └─────────────────────────────────────────┘  │
│  ┌─────────────────────────────────────────┐  │
│  │  Chat  ●  Canvas · Chat                 │  │
│  │  ...conversation with your agent...     │  │
│  │  [ type here                          ] │  │
│  └─────────────────────────────────────────┘  │
└───────────────────────────────────────────────┘
        ↑                        ↑
    WebSocket                  stdio
        ↓                        ↓
    backend  ←──── HTTP ──── mcp_server

Install

One line:

curl -fsSL https://climax.com.mx/install.sh | sh

Or with pip:

pip install climax

Then start it:

climax
# → https://local.climax.com.mx:8011

Open 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.

Why local.climax.com.mx?

Modern browsers won't let a page at https://climax.com.mx talk to http://localhost. So climax runs on the loopback address using a real Let's Encrypt certificate for local.climax.com.mx — a public DNS name that always resolves to 127.0.0.1. Traffic never leaves your machine, but the browser sees a valid HTTPS origin.

MCP tools exposed to the agent

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.

Multi-agent

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.

Development

git clone https://github.com/sheunaluko/climax
cd climax
pip install -e ".[dev]"
climax --host 127.0.0.1 --port 8011

Set PYTHON=/path/to/python ./start.sh for the convenience launcher (kills a stale instance on the port first).

Design notes

• 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.
• wait races both queues so agents never miss input on the wrong stream.

License

MIT — see LICENSE.