Quickstart

Install the Vibe CLI

brew tap dolfin/vibe && brew install vibe

Or build from source:

git clone https://github.com/dolfin/vibe.git
cd vibe
make bootstrap
cargo build -p vibe-cli --release
# binary is at target/release/vibe

vibe init myapp
cd myapp

This creates a vibe.yaml with a minimal template. Open it in your editor and describe your services.

vibe validate vibe.yaml

Fix any errors reported before packaging.

vibe package vibe.yaml -o myapp.vibeapp

vibe keygen -o my-signing
# creates my-signing.key (private) and my-signing.pub (public)

vibe sign myapp.vibeapp --key my-signing.key

Send myapp.vibeapp to anyone running macOS 14+ with the Vibe player. They double-click it and it runs.

Learn what happens when a recipient opens a .vibeapp

Deep dive into packaging options — encryption, seed data, signing