Quickstart
Drie commando's. Geen account.
Open Design heeft één entry point: pnpm tools-dev. De daemon maakt automatisch een verborgen .od/-map aan voor de SQLite project-DB en per-project artifacts. Er is geen od init stap.
Vereisten
- · Node ~24 —
nvm install 24 && nvm use 24offnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · Minimaal één ondersteunde coding-agent CLI op je
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe of Pi (of geen, als je de BYOK-proxy gebruikt)
Drie commando's
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webOpen de web-URL die tools-dev uitprint. Pop het welkomstvenster, plak een Anthropic-sleutel (alleen nodig voor de BYOK fallback-route), typ een prompt, druk op Send.
First-run state
De daemon beheert één verborgen map.
.od/
├── app.sqlite ← projecten · conversaties · berichten · open tabs
├── artifacts/ ← eenmalige "Save to disk"-renders (timestamped)
└── projects/<id>/ ← per-project werkmap, ook de cwd van de agent| Wil je… | Doe dit |
|---|---|
| Inspecteren wat erin zit | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| Resetten naar een schone lei | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| Ergens anders neerzetten | Nog niet ondersteund — het pad is hardcoded relatief aan de repo |
Lifecycle-commando's
Allemaal onder pnpm tools-dev.
pnpm tools-dev start # boot daemon + web (achtergrond)
pnpm tools-dev run web # voorgrond-equivalent
pnpm tools-dev stop # stop alles
pnpm tools-dev status # wat draait er, waar
pnpm tools-dev logs # tail daemon + web logs
pnpm tools-dev inspect # IPC naar draaiende processen
pnpm tools-dev check # health checksVoor desktop / achtergrond-startup, fixed-port restarts en mediageneratie-dispatcher details (OD_BIN, OD_DAEMON_URL), zie de QUICKSTART.md op GitHub.
Platforms · v0.5.0
Drie platforms, drie statussen.
0.5.0 doet niet alsof: per platform staat eerlijk waar het nu staat. Kies de rij die bij je machine past.
| Platform | Status | Notities |
|---|---|---|
| macOS | Stabiel | Alleen Apple Silicon (arm64) — geen Intel-build. macOS 11 Big Sur of nieuwer. |
| Windows | Stabiel · niet-gesigneerd | x64, Windows 10 / 11. SmartScreen waarschuwt bij eerste start — kies Meer info → Toch uitvoeren. |
| Linux | Alleen headless | Eersteklas CLI-lifecycle (install / start / stop) is geland in 0.5.0. Nog geen GUI-pakket — past op servers en CI. Zie hieronder. |
Linux · headless
Draai Open Design op een server zonder DISPLAY.
v0.5.0 levert een non-grafisch lifecycle-pad. Zet de daemon en web op een headless Linux-bak, en sla daarna toe vanuit de browser op je laptop. Zelfde backend, geen Electron-shell ervoor.
pnpm install
pnpm tools-pack linux install --headless # eenmalige setup
pnpm tools-pack linux start --headless # daemon + web, zonder Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # tail de headless logApt-pakketten, namespace-permissies en de FUSE-kanttekening staan in tools/pack/README.md. Geverifieerd op Ubuntu 24.04 en Arch Linux. Geland in 0.5.0 via PR #686.
Self-hosting · v0.5.0
Of draai het als één enkele container.
v0.5.0 levert een officieel Docker Compose-pad. Eén Alpine-image (docker.io/vanjayak/open-design). De daemon serveert zowel de API als de gebouwde Next.js static export — geen losse nginx, geen losse frontend-container.
git clone https://github.com/nexu-io/open-design.git
cd open-design/deploy
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose pull
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose up -d --no-build
# → http://127.0.0.1:7456Standaard: gebonden aan 127.0.0.1:7456, 384 MB memory cap, runtime-volume in /app/.od. Publiceer de daemon zo niet op een openbare interface — de API is niet geauthenticeerd voor non-browser clients. Zet er een geauthenticeerde reverse proxy, SSH-tunnel of VPN voor. Volledige docs: deploy/README.md. De image bundelt bewust geen Claude- / Codex- / Gemini-CLI's — houd die buiten de container.
En nu?
Kies iets om te renderen.
Zodra de daemon draait, heb je een skill nodig (wat te maken), een design system (hoe het eruit moet zien) en idealiter een referentie voor hoe goed eruitziet.