GettingConceptsCompilationVibeStudioCLI

VibeStudio

The desktop app for editing specs and running the compiler locally.

Overview

VibeStudio is a Tauri-based desktop application that gives you a local editing environment for your VibeHub projects. It's designed for the day-to-day workflow of writing specs, previewing generated code, and syncing with the web.

VibeStudio is available for macOS. Download the latest release or install the CLI:

Features

Spec Editor

Edit feature specs in a dedicated markdown editor with syntax highlighting for the .vibe frontmatter format (Uses, Data, Never).

Code Peek

See the generated code alongside your spec. VibeStudio uses mapping.json to show you exactly which source files correspond to each feature.

Local Compile

Run the AI compiler on your machine. Choose your model, compile, and see results in the output panel — without pushing to the cloud.

Dev Server

Start your project's dev server directly from VibeStudio. It reads project.json to determine the right command.

Push & Pull

Sync specs with VibeHub. Push creates an update (PR) on the web. Pull fetches the latest specs from the remote and commits them locally.

Chat Sidebar

Ask the AI questions about your project, get suggestions for spec improvements, or debug compilation issues.

Download

Download the latest VibeStudio DMG from the download page, or install the CLI:

curl -fsSL https://getvibehub.com/install.sh | sh

Windows and Linux desktop builds are coming soon.

Authentication & API Keys

VibeStudio has no secrets or API keys built in — it's a thin client that authenticates against the VibeHub web backend. The only config compiled into the app is the web URL (https://getvibehub.com).

Sign-in flow:

  1. Click Sign in in VibeStudio — this opens your system browser to the VibeHub web app.
  2. Authenticate with Google OAuth on getvibehub.com.
  3. After login, the web backend issues a long-lived bearer token (valid for 365 days) and redirects to a vibehub://auth?token=... deep link, which hands the token back to VibeStudio.
  4. VibeStudio stores the token locally. On future launches, it's used automatically — no need to sign in again until it expires.

Provider API keys:

When the cloud agent compiles your specs, it needs API keys for the AI provider (Anthropic, Google, OpenAI). These keys are configured in your account settings on the web app — not in VibeStudio itself. Keys are encrypted at rest (AES-256-CBC) and never sent to the desktop app. VibeStudio calls the web backend, which decrypts and uses your keys server-side.

If you haven't configured your own keys, the platform's default Gemini keys are used with reduced concurrency limits (1 active compile vs. 3 for BYOK users).

In short: sign in once via the desktop app, configure your API keys on the web, and VibeStudio uses them transparently through the backend.

Local Config

Each project's connection to VibeHub is stored in .vibe/remote.json:

{
  "owner": "your-handle",
  "repo": "my-project",
  "webUrl": "https://getvibehub.com"
}

This file is created automatically when you clone a project or connect an existing project to VibeHub. It tells VibeStudio (and the CLI) where to push and pull specs.

The owner field must match your authenticated account. The server rejects pushes where the token's user doesn't match the project owner, preventing unauthorized modifications.

Workflow

  1. Open a project — Point VibeStudio at a directory with a .vibe/ folder, or clone from VibeHub.
  2. Edit specs — Use the editor to modify features. The sidebar shows all specs in your project.
  3. Compile — Hit compile to generate code. Watch progress in the output panel.
  4. Preview — Start the dev server to see your changes live. Use Code Peek to inspect generated files.
  5. Push — When you're happy with the specs, push to VibeHub to create an update for review.