VibeSpaces
A VibeSpace keeps project folders, terminal sessions, and settings together. CrispyVibe preserves that context between app sessions and restores it when you reopen the VibeSpace.
What persists
| Category | Details |
|---|---|
| Projects | Local and SSH project folders |
| Terminals | Board layout, session state, scrollback |
| Agent conversations | Full chat history per project |
| Browser panes | URLs and state |
| Git context | Branch, status, and stash per project |
| Appearance | Theme, pane sizes, layout preferences |
Create a VibeSpace
Press Cmd+Shift+N to create a new VibeSpace from anywhere in the app.
Folder Picker
- Click New VibeSpace on the Dashboard.
- Select one or more folders, or click New Folder to create a directory and select it immediately.
A single folder creates a VibeSpace named after that folder. Multiple folders create an auto-named VibeSpace.
Creation Wizard
- Click New VibeSpace on the Dashboard.
- Enter a custom name.
- Add project folders.
- Optionally select a CLI profile.
- Click Create.
External Open
Drag one or more folders onto the CrispyVibe icon in the Dock or onto the app window. A new VibeSpace opens with those folders as projects.
Terminal Quick Start
Click Terminal Quick Start on the Dashboard. CrispyVibe opens a VibeSpace in your home directory with Terminal Board active.
View modes
Detailed
Detailed shows the file explorer, editor, and terminal pane. It is the default mode.
Terminal Board
Terminal Board arranges multiple project or standalone terminals alongside files, browsers, ACP panes, VibeCast, and Vibe Lanes. Tiles can be resized, minimized, combined in Spotlight, or moved into detached board windows.
💡 Tip: Use Terminal Board for multi-service workflows where you want to monitor terminals and related workspace surfaces together.
Launch behavior
CrispyVibe auto-restores the last active VibeSpace on launch. If no previous session exists, the Dashboard appears.
Recent VibeSpaces
The Dashboard lists your recent VibeSpaces. Click an entry to reopen it and restore its full saved state.
Unresolved paths
If a project folder has moved or been deleted, CrispyVibe flags it as unresolved. You have three options:
- Remove — delete the project from the VibeSpace
- Relink — point to the folder’s new location
- Reindex Project Folders — rescan all paths and update references
Close, remove, and delete
| Action | Result |
|---|---|
| Close | Returns to the Dashboard. The VibeSpace stays in your recent list. |
| Remove | Shuts down all sessions and removes the VibeSpace from the recent list. |
| Delete | Permanently removes configuration files from disk. |
🚨 Warning: Deleting a VibeSpace cannot be undone. All configuration files are permanently removed.
File integrity
CrispyVibe signs VibeSpace configuration files with HMAC-SHA256. If it detects external tampering, CrispyVibe disables startup commands for that VibeSpace.
To restore functionality after a tamper detection:
- Open VibeSpace Settings.
- Review the startup configuration.
- Save the settings. This re-signs the configuration files.
tmux integration
When tmux integration is enabled, tmux backs every terminal session.
- Quitting CrispyVibe detaches the tmux sessions and leaves them running.
- When you reopen the VibeSpace, CrispyVibe reattaches to existing sessions and preserves their full scrollback.
tmux session browser
The session browser displays all active and orphaned tmux sessions across your VibeSpaces. Use it to reattach to sessions that remain after their original VibeSpace is gone or to clean up orphaned sessions.
⚠️ Note: tmux must be installed and available in your PATH for this feature to function.