Workspace Side Panel
The Workspace side panel places a project’s files, git changes, and agent conversations in one view. Each project and git worktree has a collapsible row, and your Shelf sits at the top. The separate Files, Git, and Conversations tabs remain available.
Workspace is the default side panel and has its own button in the left rail (the grid icon).
Getting started
- Open a VibeSpace. The Workspace panel is shown by default.
- The panel automatically expands the focused project to show its file tree.
- Click Files, Git, Sessions, or Conversations to open a classic view.
- Click Workspace to return to the combined panel.
Switch what a project shows
Hover over a collapsed project or worktree row to reveal its + menu and three compact view toggles. The controls remain visible while the row is expanded:
- Files — the file tree (the default).
- Changes — git status, with a count badge.
- Chats — agent conversations, with a count badge.
Click a toggle to fill the row’s body with that view. When a collapsed row is not hovered, the controls stay hidden to leave more room for the project name. If the project has pending changes, its change-count badge remains visible; click the badge to open Changes.
Create files, folders, chats, and worktrees
Use the + button on a project or worktree row:
- With Files selected: New File, New Folder, and Refresh.
- With Chats selected: New Agent Chat.
On a repository row, + offers New Worktree…. See Git Worktrees for the worktree workflow.
Right-click any project or worktree row to open its context menu. It contains Make Current Project, Open in Terminal, Reveal in Finder, New File or New Folder, Copy Path, and Park Project or Remove Project. For worktrees, it provides Close Worktree or Delete Worktree instead. The classic Files pane provides the same menu; see VibeSpace Projects.
The Shelf
Your Shelf appears at the top of the Workspace panel whenever it has items, with the same open, reveal, rename, delete, remove, and clear actions as the classic Files pane.
Worktrees
Repositories with multiple git worktrees group their worktrees under a single repository row. A subdirectory opened as its own project appears as a standalone row outside that repository group. See Git Worktrees to open, create, close, and delete worktrees from here.
💡 Tip: Changes marks untracked (new) files with a green “A” badge that matches git status. Entries such as .DS_Store are hidden.
Known limitations
- Workspace does not include Sessions; use the classic Sessions rail tab.
- Workspace does not provide inline staging or commits; use the classic Source Control view.