CrispyVibe

VibeSpace Projects

A project is a folder with its own file explorer, editor, terminal, and layout within a VibeSpace.

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

You can also click Add Project Folder in VibeSpace Settings > Projects.

To add one or more projects:

  1. Open the folder picker from any of the locations above.
  2. Select one or more folders. To start a project in a folder that doesn’t exist yet, click New Folder, name the folder, and keep it selected.
  3. Click the picker’s confirm button.

CrispyVibe creates one project per selected folder. The last added project becomes the focused project. CrispyVibe silently ignores duplicate folders. If a folder is already open, CrispyVibe focuses it instead of adding it again.

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

Focused project

The main canvas displays the focused project. 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 them.

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

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

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

Project context menu

Right-click a project row to open its context menu. The classic Files pane and the Workspace side panel provide the same menu:

  • 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 does not reselect 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 use the same wording and produce the same results on project rows as on file or folder rows.

Remove a project

Remove a project using any of these methods:

  • Click the close icon on the project header in the rail.
  • Right-click an active or parked project and choose Remove Project.
  • 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 without removing it from the VibeSpace. CrispyVibe terminates its terminals, closes its browsers, and stops its file watchers. It saves the open files, terminal working directories, browser URLs, and browser history to disk, then restores them when you activate the project.

  • 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: You can also manage projects from the Agent CLI with crispy vibespace add-project, park-project, activate-project, remove-project, and list-projects.

Restart a project

Restart a project to reload its file explorer and editor and open a fresh terminal tab. Use this when a project enters a broken state or when you want to reload it 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 layout independently of other projects in the VibeSpace.