Projects & Workspaces

Workspaces

A workspace is a set of project tabs — think of one per client, product, or mode of work. The rail on the left lists your workspaces; switch instantly with Cmd+1–9 or by clicking. Each workspace keeps its own tabs, and terminals keep running when you switch away.

Auto-Discovery

Orcha automatically discovers projects by scanning ~/.claude/. Any directory where you've run Claude Code is known to Orcha and searchable. See Discovery for details.

Creating Projects

There are two ways to start a project:

• New Project— the + button. Create a brand-new folder or register an existing one; it opens as a tab — chat or terminal, per your default.
• Ask the chat— “set up a new project called billing-service.” The orchestrator creates and registers it through the same path as the manual flow, so the result is identical.

The Sidebar

Within a workspace, the sidebar shows your projects with live session status — a status line and context meter for every active session, and attention flags the moment one needs you. Sessions started outside Orcha show up too.

Git Status

Each project surfaces its git state — current branch and working-tree changes — so you can tell at a glance what an agent has actually touched.