Agent Canvas
frankjoshua/agent-canvas
Interface web live para Claude Code sessions via JSON state
Ver no GitHubPlugin que oferece uma interface web ao vivo para sessões Claude Code, controlada por um arquivo JSON de estado. O agente atualiza a UI em tempo real via SSE, permitindo dashboards, formulários e logs interativos sem sair da sessão.
Instalação
npx convez-ai frankjoshua/agent-canvas1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar dashboards e painéis de controle interativos durante desenvolvimento
- Exibir status e logs em tempo real de processamentos de agentes
- Construir interfaces de formulário para entrada de dados durante sessões de código
Veredito

Ferramenta avançada para quem quer UI rich em sessões Claude Code sem infraestrutura pesada. Requer bun, jq e curl, mas integração é plugue-e-pronto via marketplace. Ideal para prototipagem rápida de dashboards.
README
A tradução para o português deste README ainda está na fila.
agent-canvas
A Claude Code channel plugin that gives a running session a live browser UI. The agent drives it via the canvas CLI; the browser updates instantly via SSE.
Requirements
Runtime tools (assumed present, not auto-installed):
- bun — channel server runtime
- jq — used by the
canvasCLI for JSON manipulation - curl — used by the
canvasCLI to ping the server - Tailscale — for the FQDN URL (optional; falls back to
localhost)
Single-user infrastructure: not bundled with install scripts.
Install
claude plugin marketplace add frankjoshua/agent-canvas
claude plugin install agent-canvas
This installs the channel plugin, MCP server, and /canvas skill. No other setup needed.
Optionally create .canvas/ui-default.json in your project to define a starting layout.
Updating after pulling new code
The plugin runtime loads from a versioned cache (~/.claude/plugins/cache/agent-canvas/agent-canvas/<version>/), not directly from this repo. After pulling changes (git pull in ~/.claude/plugins/marketplaces/agent-canvas/), refresh the cache so live sessions see the new code:
claude plugin update agent-canvas
Or, if that doesn't pick up local changes, sync manually:
rsync -a --delete \
--exclude=node_modules --exclude='.git' --exclude='.worktrees' --exclude='.canvas' \
~/.claude/plugins/marketplaces/agent-canvas/ \
~/.claude/plugins/cache/agent-canvas/agent-canvas/0.0.1/
Then restart your Claude Code session (cl) — the new code attaches at session startup.
Agent usage
Agents update the UI via scripts/canvas.sh. See skills/canvas/SKILL.md for the full command reference. Quick example:
CANVAS="$HOME/.claude/plugins/marketplaces/agent-canvas/scripts/canvas.sh"
bash "$CANVAS" init --title "My Page"
bash "$CANVAS" html status "<span class='badge'>Running</span>"
The channel attaches automatically when you start Claude Code with --channels plugin:agent-canvas@agent-canvas-marketplace --dangerously-load-development-channels (channels are in research preview).
Network access
The server binds to 0.0.0.0 by default — accessible from any device on the same network (phones, tablets, other machines via Tailscale, etc.). Override with CANVAS_HOST if needed.
State file
Create .canvas/ui-state.json in your project:
{
"version": 1,
"title": "My Dashboard",
"theme": "dark",
"layout": "stack",
"components": [
{
"id": "greeting",
"type": "html",
"content": "<div class='card bg-base-200'><div class='card-body'><h2 class='card-title'>Hello</h2><p>Edit this file to update the UI.</p></div></div>"
}
]
}
Component types
html-- raw HTML with full DaisyUI + Tailwind classesmarkdown-- renders markdown to HTML, supports raw HTML passthroughform-- structured input form, submissions flow back as channel eventslog-- scrolling append-only log panel
User interaction
Add data-input-event to any element in an html component to make it interactive:
<button class="btn btn-primary" data-input-event="confirm">Confirm</button>
Clicks send a channel event to Claude with the event name and parent component ID.
Multiple instances
Each session gets its own port. The URL is printed to stderr and injected into the Claude Code session on startup.