VibeSpace Projects

Projects are the building blocks of a VibeSpace. Each project is a folder with its own file explorer, editor, terminal, and layout.

Add a project

Add projects from any of these locations:

The Add Project button in the toolbar
The Add Project Folder option on the Dashboard
The + button on the project rail

The last added project becomes the focused project. Duplicate folders are silently ignored.

⚠️ Note: There is no hard limit on the number of projects in a VibeSpace.

Focused project

The focused project is displayed in the main canvas. To switch focus, click a project card in the rail.

Keyboard shortcuts

Assign shortcuts Cmd+1 through Cmd+9 to your projects in VibeSpace Settings → Projects. Shortcuts are indexed by project order — reordering projects reindexes the shortcuts.

Project rail

The rail displays stacked project cards along the side of the window. Each card shows:

Compact terminal preview
Project name with its assigned color
Activity indicator for running processes

Click any card to switch focus to that project.

Reorder projects

Open VibeSpace Settings.
Select the Projects category.
Drag projects into the desired order.

Keyboard shortcuts (Cmd+1 through Cmd+9) update to match the new order.

Right-click a project row for its full menu. It’s the same menu whether you’re in the classic Files pane or the Workspace side panel — the two surfaces stay in parity:

Make Current Project — focus the project and make it current (same as clicking its stacked card).
Open in Terminal — always opens a new terminal tab at the project root (it never just re-selects an existing terminal).
Reveal in Finder — show the project folder in Finder. Hidden for remote/SSH projects.
New File / New Folder — create an item at the project root.
Copy Path — copy the project’s path to the clipboard.
Park Project — persist state and end sessions without removing it (see below).
Remove Project — take it out of the VibeSpace (see below). For a git worktree child, this appears as Close Worktree / Delete Worktree instead — see Git Worktrees.

Open in Terminal, Reveal in Finder, New File, New Folder, and Copy Path behave exactly like the same actions on a file or folder row, so wording and results are consistent everywhere.

Remove a project

Remove a project using any of these methods:

Click the close icon on the project header in the rail.
Right-click a project and choose Remove Project — this works for both active and parked projects.
Open VibeSpace Settings → Projects and click Remove next to the project.

Focus falls back to the last remaining project.

🚨 Warning: Removing a project closes its terminals and editor tabs and takes effect immediately with no confirmation prompt. The folder itself is not deleted from disk.

Park and activate projects

Parking puts a project into a dormant state — terminals terminated, browsers closed, file watchers stopped — without removing it from the VibeSpace. Its full state (open files, terminal working directories, browser URLs and history) is persisted to disk and restored when you activate it later.

On an active project, right-click and choose Park Project. It moves to a “Parked Projects” section at the bottom of the Files tab.
On a parked project, right-click and choose Activate Project to bring it back into focus with terminals and browser tabs restored.

💡 Tip: Project lifecycle actions are also scriptable from the Agent CLI with crispy vibespace add-project, park-project, activate-project, remove-project, and list-projects.

Restart a project

Restarting a project reloads its file explorer, restarts the editor, and opens a fresh terminal tab. Use this when a project enters a broken state or you need a clean slate without removing and re-adding it.

Layout persistence

Drag dividers between the explorer, editor, and terminal to resize panes. CrispyVibe saves these dimensions per project — each project retains its own layout independent of others in the VibeSpace.