VibeSpaces
A VibeSpace groups project folders, terminal sessions, and settings into a single context. Everything you configure persists across sessions — quit CrispyVibe and pick up where you left off.
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.
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.
- A VibeSpace opens in your home directory with terminal-only mode active.
View modes
Detailed
The full project view with file explorer, editor, and terminal board visible. This is the default mode.
Terminal Only
Each project gets its own terminal pane. Switch between horizontal and vertical orientation from the toolbar.
💡 Tip: Terminal Only mode is useful for multi-service workflows where you need to monitor several processes at once.
Launch behavior
CrispyVibe auto-restores the last active VibeSpace on launch. If no previous session exists, the Dashboard appears.
Recent VibeSpaces
The Dashboard displays your recent VibeSpaces. Click any entry to reopen it with its full state restored.
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
VibeSpace configuration files are signed with HMAC-SHA256. If a file is tampered with externally, 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, every terminal session is backed by a tmux session.
- Quitting CrispyVibe detaches the tmux sessions instead of terminating them.
- Reopening the VibeSpace reattaches to existing sessions with full scrollback preserved.
tmux session browser
The session browser displays all active and orphaned tmux sessions across your VibeSpaces. Use it to reattach to sessions that outlived their original VibeSpace or to clean up orphaned sessions.
⚠️ Note: tmux must be installed and available in your PATH for this feature to function.