VibeLign v2.4.0

Highlights

v2.4.0 is the biggest GUI release since v2.3.0. Design Preview grows from five fixed presets into an open-ended style synthesizer driven by plain-language input, with background generation that survives tab switches. Across the board, synchronous Tauri commands that were freezing the UI during heavy work have been replaced with async + spawn_blocking, so the app stays responsive no matter what is running. AI tool installation, a guided run/verify onboarding flow, and automatic baseline commits at vib start round out the release.

Highlights / Key Changes

  • Design Preview — plain-language style synthesis: Describe a style in everyday words (or pick an example chip) and Claude synthesizes it on the spot, renders a card preview, and auto-generates a mockup. Includes color-swatch instant re-paint (no LLM re-call), custom style save/list/delete, and a step-by-step progress panel during generation.
  • Design Preview — background generation: Navigating away from the Design tab no longer cancels generation. A status chip at the top of the app tracks progress and brings you back on click (useDesignJob hook promotes job state to app lifetime).
  • UI freeze fixes (async Tauri commands): generate, synthesize_style, read_project_summary, git summary, four vib docs-index commands, and install_tool were all blocking the main thread synchronously. All converted to async + spawn_blocking; the UI now stays interactive during any heavy operation.
  • AI tool one-click install: Install opencode, codex, or antigravity (agy) directly from the app — platform-aware commands (Windows/macOS), real-time log panel, auth guidance, and manual fallback. opencode installs without an API key, eliminating the “no tool” dead-end in the Planning Room for beginners.
  • Onboarding — run/verify flow: Home Step 5 now has a “Try running it” button. The app detects the running port, opens an embedded WebView, and advances to Step 6 only after runVerified passes.
  • Onboarding — design branch discovery: After a plan is confirmed, the app surfaces a “Set the design first” branch to direct users to Design Preview.
  • Onboarding — non-blocking git warning: Missing git shows a persistent top-bar banner instead of blocking the screen.
  • vib start baseline commit: A first git commit is created automatically so change detection works correctly on brand-new projects (zero prior commits). Default .gitignore now includes node_modules/ and .DS_Store.

Install

The desktop app updates automatically via the built-in updater — no action needed.

CLI:

# pip
pip install --upgrade vibelign

# uv (recommended)
uv tool install vibelign        # first time
uv tool upgrade vibelign        # upgrade

주요 변경

v2.4.0은 v2.3.0 이후 가장 큰 GUI 릴리즈입니다. 디자인 미리보기가 다섯 가지 고정 프리셋에서 일상어 자유 입력 기반의 스타일 합성기로 진화했고, 탭을 이동해도 생성이 이어지는 백그라운드 잡 시스템이 추가됐습니다. 무거운 작업 중 UI를 얼어붙게 하던 동기 Tauri 커맨드 전체를 async + spawn_blocking으로 전환해 앱이 항상 반응합니다. AI 도구 원클릭 설치, “실행해보기” 온보딩 흐름, vib start 베이스라인 커밋이 더해져 처음 사용자의 막힘 지점을 제거했습니다.

주요 변경

  • 디자인 미리보기 — 자유 입력 스타일 합성: 일상어나 예시 칩으로 스타일을 설명하면 Claude가 즉석 합성하고 카드 미리보기와 목업을 자동 렌더한다. 색 스와치 즉시 재색칠(LLM 재호출 없음), 커스텀 스타일 저장/목록/삭제, 단계별 진행 패널 포함.
  • 디자인 미리보기 — 백그라운드 생성: 생성 도중 디자인 탭을 벗어나도 작업이 취소되지 않는다. 상단 진행 칩으로 상태 확인, 클릭 시 결과 탭으로 복귀(useDesignJob 훅으로 잡 상태를 앱 수명으로 승격).
  • 앱 멈춤 해소 (비동기 Tauri 커맨드): generate·synthesize_style·read_project_summary·git 요약·vib docs-index 4종·install_tool 가 모두 메인 스레드를 동기 점유했다. 전부 async + spawn_blocking으로 전환해 무거운 작업 중에도 UI가 반응한다.
  • AI 도구 원클릭 설치: opencode·codex·antigravity(agy)를 앱 안에서 바로 설치한다. 플랫폼별 명령(Windows/macOS), 실시간 로그 패널, 인증 안내, 수동 폴백 포함. opencode는 API 키 없이 설치 가능해 기획방 “도구 없음” 데드엔드를 제거한다.
  • 온보딩 — 실행해보기 + 작동 검증: 홈 5단계에 “실행해보기” 버튼 추가. 앱 포트 감지 → 내장 WebView 렌더 → runVerified 확인 후 6단계로 진행.
  • 온보딩 — 디자인 분기 발견성: 기획 확정 후 “디자인 먼저 정하기” 분기를 노출해 디자인 미리보기로 안내.
  • 온보딩 — git 미설치 비차단 경고: git이 없을 때 화면 전체를 막는 대신 상단 배너로 상시 경고.
  • vib start 베이스라인 커밋: 신규 프로젝트에 초기 git 커밋을 자동 생성해 커밋 0개 상태에서도 변경 감지가 정상 작동. 기본 .gitignore에 node_modules/·.DS_Store 추가.

설치

데스크톱 앱은 내장 업데이터가 자동 업데이트합니다 — 별도 작업 불필요.

CLI:

# pip
pip install --upgrade vibelign

# uv (추천)
uv tool install vibelign        # 처음 설치
uv tool upgrade vibelign        # 업그레이드