Skip to content
sheunalukoPublic

About

Opensource Agentic CLI Tool

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

15 Commits

Folders and files

Repository files navigation

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

🌐 climax.com.mx — hosted UI · climax.com.mx/app — launch straight into the app (talks to your local backend over CORS)

Demo

climax demo: launching a Claude Code agent and watching it author a welcome UI

Real recording: empty state → + agent → Claude Code → agent authors a welcome UI on the canvas. Watch the full-quality MP4.

agent-authored HTML rendering on the canvas — a palette generator mini-app live pty terminal in climax showing a running Claude Code session
Agents render real apps. One page_set(html) call → your idea rendered live in a sandboxed iframe. postMessage events pipe back so the agent can react to clicks. See the CLI session, live. The pty terminal streams into an xterm.js panel — thinking, tool calls, output. Type into it, resize it, Ctrl-C it.

Install

One line:

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

Or with pip (pre-release for now — remove --pre once 0.1.0 ships):

pip install --pre python-climax

The PyPI name is python-climax because plain climax was already taken. The command and import name are still climax.

Then start it:

climax
# → http://127.0.0.1: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.

MCP tools exposed to the agent

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.

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.

About

Opensource Agentic CLI Tool

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages