CrispyVibe

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

  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.

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

Right-click a project for lifecycle actions:

  • On an active project, choose Park to persist its state and end its sessions without removing it from the VibeSpace.
  • On a parked project, choose Activate to unpark it and bring it back into focus.

💡 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.