Getting Started
Get CrispyVibe running and create your first workspace.
Requirements
- macOS 26 or later
- Apple Silicon Mac (M1 or later)
- Apple Intelligence enabled for Terminal Insights (optional)
Terminal rendering
CrispyVibe uses Ghostty for GPU-accelerated terminal rendering, with full Unicode support and accurate color reproduction without any configuration.
Install
- Download the DMG.
- Drag CrispyVibe to Applications.
- Open CrispyVibe.
Create a VibeSpace
- Click New VibeSpace on the Dashboard.
- Name it and add one or more project folders (local or SSH).
- Choose a default AI agent or skip to add one later.
- Click Create to open your workspace with the Terminal Board ready to use.
Add an AI agent
CrispyVibe discovers installed agents from your PATH. Built-in agent support includes:
- Kiro CLI
- Claude Code
- Codex
- Gemini CLI
- OpenCode
- GitHub Copilot CLI
Add a custom agent in Settings > Agents by specifying its command and arguments.
💡 Tip: If you install an agent after launching CrispyVibe, restart the app so it can discover the new executable.
Next steps
- Open the Terminal Board to arrange terminals in a grid layout.
- Use Terminal Spotlight to switch between sessions with a keyboard shortcut.
- Configure VibeSpace Settings to set startup profiles and terminal defaults.