Drawa

Your coding agents, on a canvas.

Run Claude Code, OpenCode and Codex side by side, watch every file they read, edit and run as a live map, and review each change without leaving the browser.

drawa.cc

Install · Quick start · Features · Shortcuts · Contributing

In a terminal, an agent's work scrolls past as a transcript. Drawa lays it out as a map instead.

• Several agents at once. Each session is a card on the canvas: Claude Code, OpenCode or Codex, side by side, on the same project.
• Work drawn as a map. The files each agent reads, edits and writes appear in a window wired to its card, colored by what happened to them. The commands it runs collect beside it.
• Review in place. Click any file for its diff from every session, and approve or answer the agent from the card it's running in.

Drawa runs entirely on your machine. It drives the agent CLIs you already have, with your logins, settings, skills and MCP servers, and serves the UI on 127.0.0.1.

No Claude subscription? OpenCode is an open-source coding agent that works with most model providers (OpenRouter, Google, OpenAI, local models and more), and Codex is OpenAI's. With either installed, New session ▾ in the toolbar offers it next to Claude Code, and each session card picks its model from that agent's list. Drawa's startup check lists the agents it finds, and warns if a version isn't the one Drawa was tested with.

Neither OpenCode nor Codex has an agent-specific process limit: set DRAWA_MAX_LIVE if your machine needs one. The Git window's Write with ▾ picks which agent writes commit messages and pull request descriptions.

• OpenCode privacy. A session's prompts, and the files it reads, go to the provider you pick. OpenCode's free models are run by third parties that may use what you send to improve their models (check OpenCode Zen's terms), so don't use them on code you can't share.
• Codex trust. For a local folder, Drawa marks it trusted for Codex, so, as with Claude Code, its .codex/ settings and AGENTS.md load. A cloned GitHub repo you didn't trust is marked untrusted, so they don't. Either way nothing is written to ~/.codex/config.toml.

curl -fsSL https://raw.githubusercontent.com/HimalayanNomads/drawa/main/install.sh | sh

This downloads the right release binary for your OS and architecture and installs it to ~/.local/bin/drawa. You don't need Go or Node.

Update later with drawa --update. For manual downloads, custom install locations and uninstalling, see INSTALL.md.

git clone https://github.com/HimalayanNomads/drawa.git
cd drawa/web && npm install && npm run build
cd .. && go build -o drawa .

cd ~/my/project
drawa

Drawa opens http://127.0.0.1:8765 in your browser, and Claude works in that folder. Press N for a new session and start typing.

drawa                  # the current folder
drawa ~/some/project   # any other folder
drawa --net .          # also reachable from other devices on the network
drawa https://github.com/owner/repo   # clones it into a cache folder and opens it (reruns reuse the clone)
drawa --clean          # removes cached clones (or pass one repo's URL)

Opening a GitHub URL, or a folder inside its clone, asks on each launch whether to trust the repo (only the server's own restarts after code changes reuse the answer). Answer n (the default) and its own .claude/ settings, hooks, .mcp.json, CLAUDE.md, OpenCode project config, and Codex's .codex/ config and AGENTS.md are ignored, since they could run commands on your machine.

--clean keeps any clone with uncommitted, unpushed, stashed or ignored files. Don't run it while a Drawa is open on that clone. A GitHub folder link (/tree/main/docs) opens the repo on its default branch.

In the message box, / opens skills and slash commands and @ references files or canvas items. The toolbar picks the model and permission mode.

By default Drawa only answers on localhost. Pass --net (in any position) and, like a Vite or Next.js dev server, it also listens on the machine's network address and prints both:

  - Local:   http://127.0.0.1:8765
  - Network: http://192.168.1.23:8765/?token=fpKZrzCN

It also prints a QR code of the Network link, so a phone can open it with its camera. The Network link lets another device on the same network — a laptop, a phone — open the same workspace. It only works with its ?token= (a fresh one each run, checked once, then kept in a cookie and dropped from the address), and an address that guesses wrong 5 times locks out for a few minutes. See Security.

• Parallel sessions. Each card is a live agent process: Claude Code, OpenCode or Codex, picked per session. Type any time; messages queue while the agent or its sub-agents work.

• Your work, drawn as a map. Files the agent reads, edits and writes are linked to its card and colored by action. Commands it runs collect in their own window.

• Review in place. An edit waiting for approval shows its diff inside the card. Click any file for its changes from every session, plus the file itself with Markdown and Mermaid preview.

• Sub-agents in the open. Each sub-agent gets its own window showing its work as it happens, and you can message it directly.
• Agents can use the canvas too. They can read, create, edit and link canvas items through built-in tools, with changes going through the normal approval flow.
• A whiteboard around your code. Sticky notes, a Markdown scratchpad, Mermaid diagrams, pictures, pinned snippets, shapes, arrows and freehand ink. @-reference any of them in a message, or drop them on a card.

• Git and GitHub built in. Browse status and history, commit and push. Repos in subfolders (a folder of cloned repos, or repos inside your project) get a group each in the Git window, with their own pull request, and the GitHub window switches between them. Open pull requests and issues through gh, and send a PR, its failing checks or its reviews straight to a session.

• Picks up where you left off. Resume past sessions from history. The whole layout survives a reload, and a reload re-attaches to sessions that are still running.
• Works on your phone. Start with --net and open the printed link or QR code: the same canvas, starting in Hand mode so a drag pans.

• Themes. Light and dark, with Rosé Pine, Catppuccin, Tokyo Night, Gruvbox, Nord, Kanagawa, Everforest, Solarized and GitHub color schemes.

DRAWA_PORT=8766 CLAUDE_CONFIG_DIR=$HOME/.claude-work drawa ~/other/project

Settings that follow you to every project and browser live in ~/.drawa/config.json. Drawa writes it with the defaults the first time it starts, and the Settings panel (the gear in the toolbar) changes it. You can also edit it by hand: the change applies the next time you reload the page. A file that isn't valid JSON is left alone, and the defaults apply until it's fixed.

{
  "darkScheme": "claude-dark",
  "lightScheme": "claude-light",
  "theme": "system",
  "ui": "full"
}

Fonts and which key sends a message are kept per browser.

Shortcuts follow Excalidraw's where the tool exists, and don't fire while you're typing. Press ? in the app for this list, and Ctrl+K to run any action by name. A short tip shows in the corner at launch; Hide tips turns them off.

Mouse: drag the background to select (Select mode) or pan (Hand mode). The middle button and the wheel always pan. Ctrl/Cmd+scroll or pinch zooms; Shift+scroll scrolls sideways. The zoom is saved with the canvas. Jumping to a window (Ctrl+K, C, a notification) keeps the zoom unless the window would be under 50% or wouldn't fit, then it zooms to fit that window (at most 100%). Click a picture or diagram for full view, and click it again to zoom and pan it. Phones start in Hand mode.

Drawa is built to run locally for one user:

• The server listens on 127.0.0.1 only, unless you pass --net (see Quick start), and checks the Host header on every request either way.
• With --net, the network address additionally needs its one-time ?token=; wrong guesses lock that address out after 5 tries. Still only pass --net on a network you trust, and treat the printed link like a password — don't post it anywhere public.
• Changing requests must come from Drawa's own page (a matching Origin).
• File access is confined to the project folder you opened.
• Claude's canvas tools use a per-process token, so only that session's own claude process can call them.

To report a vulnerability, see SECURITY.md: please open a private security advisory rather than a public issue.

Questions, ideas and things you built with Drawa go to Discussions. Issues and pull requests are welcome. Maintainers cut the releases; a merged pull request ships in the next one. See CONTRIBUTING.md for the development setup and an architecture overview, and CLAUDE.md for the conventions the codebase follows. Everyone taking part is expected to follow the Code of Conduct.

Drawa is licensed under the GNU Affero General Public License v3.0.