free forever · macOS 14+ · unsigned alpha build

Download VibeCrew.

One .dmg, no account, nothing phones home. Everything between here and your first running agent is on this page — including the parts other download pages leave out.

01 / before you download

Three things it needs from your machine.

1
macOS 14 or newer

VibeCrew is a native Mac app. Everything it keeps lives in ~/.vibecrew/ — a SQLite file, worktrees, pipelines. No cloud, no daemon.

2
git

Isolation is git worktrees, not containers: every card’s agent works on its own branch in its own directory, and nothing reaches your main branch without a merge.

3
At least one coding agent CLI

claudecodexopencodepiClaude Code, Codex, OpenCode, or Pi — with your own subscription or API key. VibeCrew doesn’t resell model access; your agents run under your accounts.

02 / the agreement

Read this once. It’s short, and it’s the deal.

  • ❯It’s an alpha. Rough edges exist. Issues get handled in days, not quarters — but they get handled because you hit them first.
  • ❯Real agents, real permissions. Coding agents edit files, run commands, and use git under your user account. Worktrees keep them off your main branch — not off your computer. Dial autonomy to what you trust.
  • ❯Your keys, your bills. Agents run on your subscriptions and API keys. What they spend is yours — the app shows you tokens and cost per run, live.
  • ❯No warranty, no liability. VibeCrew is provided as-is. If something breaks we genuinely want to hear about it — but the responsibility for running it is yours alone.
Download VibeCrew.dmg
the button lights up when the box is checked
03 / first launch

macOS will object once. Here’s the handshake.

Alpha builds aren’t signed with an Apple Developer certificate yet, so Gatekeeper flags the first open. It’s a one-time gesture — after that, macOS remembers.

1
Drag it in

Open the .dmg and drag VibeCrew.app into Applications.

2
Right-click → Open → Open

A plain double-click shows the warning without an Open button. Right-click (or Control-click) is the one with the escape hatch.

3
If it still refuses

System Settings ▸ Privacy & Security ▸ scroll down ▸ Open Anyway.

# the terminal version of the same gesture
$ xattr -dr com.apple.quarantine /Applications/VibeCrew.app
04 / first run

Five minutes, once.

1
Let onboarding walk you through

The first-run sheet registers a git repo by its path, creates a project on top of it, and picks your default coding agent. Want a do-over later? Settings ▸ Data ▸ Reset onboarding.

2
Sync the plugin catalog

Settings ▸ Agents ▸ Plugins ▸ Manage… ▸ Sync Catalog installs VibeCrew’s skills and subagents into each CLI’s own global config. It never overwrites a file it didn’t write.

3
Give the Assistant its handbook

Settings ▸ Assistant ▸ Handbook ▸ Download handbook — so the agent inside the app can answer questions about the app. Optional, worth it.

4
Write a card. Start it.

Give it a pipeline, press Start, and watch it in Fleet — or don’t. That’s rather the point.

# where everything lives
~/.vibecrew/vibecrew.sqlite — the board: cards, projects, config
~/.vibecrew/worktrees/ — where agents actually work
~/.vibecrew/pipelines/ — your pipelines, plain TOML
127.0.0.1:48620 — the embedded server. Local only, always
05 / settings

Nine tabs, and what each one owns.

You’ll open Agents and Pipelines in week one; the rest can wait until they’re needed.

General
Backend status, GitHub token, branch prefix, worktrees root
Agents
Default coding agent and variant, per-agent profiles, and the Plugin Manager
Assistant
Dictation cleanup, speech-to-text and voice-output models, the handbook download
Projects
Your projects, and which repos each one links
Pipelines
The card pipelines, editable as TOML — your file overrides the bundled one
Skills
The skills library
Repositories
Registered git repos, per-repo scripts, default branch
MCP
Servers injected into every Claude Code agent VibeCrew spawns
Data
Config export and import, reset onboarding
worth knowing · Two different things share the Assistant tab: the small model that cleans up dictation, and the Assistant host agent with its handbook. Same name, separate settings.
worth knowing · Telegram escalation needs a bot token and chat id, set by hand in Settings. They’re secrets — deliberately unreadable and unwritable by any agent, including VibeCrew’s own.

Want to see what you’re getting before the .dmg finishes?

Take the tour