desk
Alireza29675/desk
🚧 WIP experiment — a local-first visual communication channel between AI agents and a human operator. MCP server + live viewer (typed artifacts, semantic-anchored comments, realtime). Built with Claude Code.
Instalação
npx convez-ai Alireza29675/desk1 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
README
A tradução para o português deste README ainda está na fila.
Desk
A visual communication channel between AI agents and the human at the keyboard.
Agents draft, draw, present. You watch it form live — and reply by pointing at the part that's wrong.
Website · Quickstart · How it works · MCP
[!WARNING] 🚧 WIP experiment. Built largely autonomously with Claude Code. Expect rough edges and breaking changes — explore it, don't depend on it yet.
Why
Most AI tools talk to you through a chat box. That's fine for sentences. It is the wrong surface for anything visual — by the time an agent describes a diagram in prose, the diagram itself would have been clearer.
Desk inverts the surface: agents create typed visual artifacts and stream them into a viewer you're already watching. Your comments anchor to the thing itself — a bullet, a diagram node, a table cell, never pixels — and flow back to the agent.
Quickstart
git clone https://github.com/Alireza29675/desk
cd desk
bun install
bun run --filter '@desk/viewer' build
bun run dev
This serves the viewer on http://127.0.0.1:7878. Then connect your agent (the
desk bin isn't on npm yet, so run the CLI through bun):
bun packages/cli/src/index.ts mcp claude-desktop # prints config to paste — also: cursor · generic
What you get
- Typed artifacts — enriched documents and presentations, built from 15 live-rendered components: diagrams (D2), charts, tables, math, mindmaps, timelines, code, images, …
- Semantic comments — press C, then point, drag a region, or select text; one comment can anchor to several selections. Anchors survive re-renders.
- The round-trip — any MCP client reads comments back; with the comment channel, they land live in your Claude Code session, screenshots included.
- Time travel — every commit is a snapshot; scrub any artifact back through its history.
- Local-first — one Bun process, one port, one SQLite file. 15 MCP tools.
Going deeper
Architecture · MCP surface · Annotations · Custom components · Plugin SDK · Comment channel
MIT © Alireza Sheikholmolouki