VibeSpace Settings
Open VibeSpace Settings from the toolbar gear icon or from the Dashboard context menu on any VibeSpace. The panel uses a split layout: categories on the left, detail on the right.
Categories
Settings are organized into two categories:
- VibeSpace Settings — workspace-level configuration
- Projects — per-project overrides
VibeSpace name
Edit the VibeSpace name at the top of the settings panel. Press Enter to save.
Startup configuration
Terminals per project
Set the number of terminal tabs that open per project on startup (1–8).
Startup profiles
Assign a startup profile to each terminal slot:
| Profile | Behavior |
|---|---|
| None | Terminal opens with no command |
| Preset: Standard | Runs the command with standard trust level |
| Preset: Full Trust | Runs the command with elevated permissions |
| Command | Runs a custom command you specify |
Focus terminal on project switch
Enable this option to automatically focus the terminal pane when you switch between projects.
Execution order
Startup defaults apply once per project per session. The focused project starts first, followed by the remaining projects in rail order.
Maintenance
Reindex Project Folders
Click Reindex Project Folders to rescan all project paths. Use this after moving folders or resolving broken references.
Source control
| Setting | Default | Description |
|---|---|---|
| Ignored folders | — | Folders excluded from git scanning |
| Scan depth | 8 | How deep to search for repositories |
| Max discovered repos | 64 | Upper limit on repositories found per project |
| Max rendered repos | 12 | Repositories shown in the source control sidebar |
Projects category
The Projects category lists all projects in the current VibeSpace.
Add a project
Click Add Project Folder to browse for a new folder.
Per-project settings
Each project entry exposes:
- Color — custom color assignment
- Shell — override the default shell
- Shortcut — assign
Cmd+1throughCmd+9 - Startup override — per-project startup profile that overrides the workspace default
Reorder projects
Drag project entries to change their order. Keyboard shortcuts reindex to match.
Remove a project
Click the trash icon next to a project entry to remove it from the VibeSpace.