Quickstart
명령어 셋. 가입 없음.
Open Design의 진입점은 단 하나: pnpm tools-dev. daemon이 SQLite 프로젝트 DB와 프로젝트별 artifact를 위한 숨김 .od/ 폴더를 자동 생성합니다. od init 단계 없음.
전제
- · Node ~24 —
nvm install 24 && nvm use 24또는fnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - ·
PATH위에 지원되는 coding-agent CLI 한 개 이상 — Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe, Pi 중 하나(또는 하나도 없이 BYOK 프록시 사용)
명령어 셋
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webtools-dev가 출력하는 웹 URL을 엽니다. 환영 다이얼로그를 열고, Anthropic Key를 붙이고(BYOK 폴백을 쓸 때만 필요), prompt를 입력, 전송.
첫 실행 상태
daemon이 관리하는 숨김 폴더는 단 하나.
.od/
├── app.sqlite ← projects · conversations · messages · open tabs
├── artifacts/ ← 일회성 「디스크에 저장」 렌더링 (타임스탬프 포함)
└── projects/<id>/ ← 프로젝트별 작업 디렉토리, Agent의 cwd| 하고 싶은 것… | 이렇게 |
|---|---|
| 안에 뭐가 있나 보기 | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| 깨끗한 상태로 리셋 | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| 다른 위치로 옮기기 | 아직 미지원 — 경로가 리포지토리 상대로 하드코딩됨 |
라이프사이클 명령어
전부 pnpm tools-dev.
pnpm tools-dev start # daemon + web 시작 (백그라운드)
pnpm tools-dev run web # 동등한 포어그라운드 실행
pnpm tools-dev stop # 모두 중지
pnpm tools-dev status # 무엇이 어디서 도는지
pnpm tools-dev logs # daemon + web 로그 추적
pnpm tools-dev inspect # 동작 중 프로세스에 IPC
pnpm tools-dev check # 헬스 체크데스크톱 / 백그라운드 시작, 고정 포트 재시작, 미디어 생성 디스패치 세부(OD_BIN, OD_DAEMON_URL)는 GitHub의 QUICKSTART.md 참고.
플랫폼 · v0.5.0
세 플랫폼, 세 가지 상태.
v0.5.0은 각 플랫폼의 현재 상태를 솔직하게 알립니다. 본인 머신에 맞는 줄을 고르세요.
| 플랫폼 | 상태 | 비고 |
|---|---|---|
| macOS | 안정 | Apple Silicon (arm64) 전용 — Intel 빌드 없음. macOS 11 Big Sur 이상. |
| Windows | 안정 · 미서명 | x64, Windows 10 / 11. SmartScreen이 첫 실행에서 경고 — More info → Run anyway를 선택해 진행. |
| Linux | headless 전용 | v0.5.0부터 CLI 라이프사이클(install / start / stop)이 일급 지원. GUI 패키지는 아직 없음 — 서버와 CI에 적합. 아래 참조. |
Linux · headless
DISPLAY 없는 서버에서 Open Design 돌리기.
v0.5.0은 비그래픽 라이프사이클 경로를 출하합니다. headless Linux 머신에서 daemon과 web을 띄우고, 노트북 브라우저로 두드립니다. 백엔드는 동일, 앞에 Electron 셸이 없을 뿐.
pnpm install
pnpm tools-pack linux install --headless # 1회 초기화
pnpm tools-pack linux start --headless # daemon + web, Electron 없음
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # headless 로그 추적Apt 패키지, namespace 권한, FUSE 주의사항은 모두 tools/pack/README.md에 있습니다. Ubuntu 24.04와 Arch Linux에서 검증. 0.5.0 PR #686로 도입.
자가 호스팅 · v0.5.0
또는 단일 컨테이너로.
v0.5.0은 공식 Docker Compose 배포 경로를 제공합니다. Alpine 이미지 하나(docker.io/vanjayak/open-design). daemon이 API와 빌드된 Next.js 정적 익스포트를 함께 서빙 — 별도 nginx도, 별도 프론트엔드 컨테이너도 필요 없음.
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:7456기본값: 127.0.0.1:7456 바인딩, 메모리 상한 384 MB, 런타임 볼륨은 /app/.od에 마운트. daemon을 공개 인터페이스에 그대로 노출하지 마세요 — 비브라우저 클라이언트에 대해 API에 인증이 없습니다. 앞에 인증된 리버스 프록시, SSH 터널, 또는 VPN을 두세요. 전체 문서: deploy/README.md. 이미지는 설계상 Claude / Codex / Gemini CLI를 번들하지 않습니다 — 그것들은 컨테이너 밖에 두세요.
그래서 다음은?
뭔가를 렌더링해 보기.
daemon이 뜨면 Skill(무엇을 만들지), 디자인 시스템(어떻게 보일지)이 필요하고, 「좋다는 게 뭐인지」 참고도 하나 있으면 좋습니다.