Excalidraw diagrams from a description.
Describe a system or a process in a sentence. Sketchi draws it with each product's logo, and every part stays editable.
Sketchi works from a sentence, or from a typed spec that an agent or the CLI writes. A model's answer is never the drawing: it is parsed into a typed diagram, validated, laid out by code, converted to real Excalidraw elements, and stored with a PNG. It draws flowcharts (with groups, swimlanes and architecture zones), mindmaps, sequence diagrams, timelines, bar, line and pie charts, state machines, Gantt charts, ER diagrams, UML class diagrams, org charts, Venn diagrams, user journey maps, Sankey diagrams, UI wireframes and quadrant charts.
CLI. Install the sketchi command
and turn a description into a PNG you can revise later. Generation needs no
account or API key; authoring, editing and export work offline.
curl -fsSL https://sketchi.app/install.sh | sh # or: npm install -g sketchi
sketchi generate --prompt "Deploy with GitHub Actions, Docker and Cloudflare Workers"The CLI guide covers every command, and the changelog what changed.
Agents. Codex, Claude Code, Antigravity and OpenCode draw through the public
MCP server at https://playground.sketchi.app/mcp, with no login or local
browser. The agent quickstart installs the
plugin or skill for each, and the Code Mode API page
describes the server.
Browser. playground.sketchi.app drafts and edits diagrams in chat, and icons.sketchi.app is the icon library diagrams draw their logos from.
prompt ─▶ model candidate ─▶ typed diagram ─▶ deterministic layout ─▶ Excalidraw scene ─▶ stored artifact + PNG
▲
spec from the CLI or MCP
| Package | Owns |
|---|---|
packages/diagrams |
family contracts, layout, readout, shared graph, build and generation |
packages/cloudflare |
concrete shared AI Gateway binding adapter |
packages/drawing |
Excalidraw conversion, real-scene validation and SVG import |
tools/scenarios |
maintained scenarios and the scenario CLI |
packages/editor-surface |
reusable React drawing surface (Nx editor-surface) |
packages/icons/* |
the icon catalog and search, community icons, and hand-drawn logos |
packages/observability |
best-effort request span export for Studio and Icons |
packages/ui |
shadcn primitives and tokens for the Tailwind apps |
App (apps/) |
Nx project | Serves |
|---|---|---|
cli |
sketchi-cli |
the sketchi command |
studio |
studio |
playground.sketchi.app: Studio, the HTTP API and the MCP server |
web |
web |
sketchi.app: home, docs and agent setup |
icons |
icons |
icons.sketchi.app |
editor |
editor |
an internal Excalidraw workspace for checking real scenes |
Every app except the CLI is a Cloudflare Worker. See the architecture guide and, for each family, adding a diagram family.
mise pins Node and pnpm:
mise trust && mise install
pnpm install
pnpm dev # all four Worker apps
pnpm nx dev studio # one app| App | Local URL |
|---|---|
| Web | http://127.0.0.1:6201 |
| Editor | http://127.0.0.1:6202 |
| Icons | http://127.0.0.1:6203 |
| Studio | http://127.0.0.1:6210 |
The dev servers use fixed ports and fail if a port is in use. Icons and Studio
use remote Cloudflare bindings. If your Cloudflare login can access multiple
accounts, set CLOUDFLARE_ACCOUNT_ID to the Sketchi account before starting dev, e.g. in a
gitignored mise.local.toml [env] table alongside INFISICAL_PROJECT_ID.
To make Web link to local Icons and Studio, see
Web's local setup.
pnpm ci:local is the gate: lint and format, typecheck with the native
TypeScript 7 compiler, build and test for every project the change
affects, plus the tooling and deploy checks. Remote CI on a pull
request is one Nx-affected typecheck. AGENTS.md explains
unit gates against a verified staging base, the full gate required for signoff,
and additional checks when their inputs change.
For optional visual review, pnpm storybook starts the
diagram family gallery and
pnpm build-storybook builds it locally.
A CLI change that should ship gets a changeset (pnpm changeset); merging the
Version Packages pull request publishes it.
Graded evals run outside this repository against the scenarios in
tools/scenarios. pnpm sanity runs three end-to-end checks
against production or a preview.
A push to main deploys the production Worker apps its changes reach; an
app-production-deploy dispatch deploys every app or one. A pull request gets
preview Workers when it carries the preview label; see
preview deployments and the
production domain map and procedures.
MIT. See LICENSE.
