Skip to main content

​
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

​
Create your first app

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

​
Validate the manifest

vibe validate vibe.yaml
Fix any errors reported before packaging.

​
Package the app

vibe package vibe.yaml -o myapp.vibeapp

​
Generate a signing keypair

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

​
Sign the package

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

​
Share it

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

​
Next steps

Open an app

Learn what happens when a recipient opens a .vibeapp

Package an app

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