Skip to main content
A workspace is the unit p0 organizes work around. It owns a set of repos (from GitHub or GitLab) and the standards the agent reads before writing code. One workspace per project; switch between them from the sidebar.

What’s inside a workspace

p0 manages the workspace folder for you. The repos you attach get cloned underneath it, and the standards p0 generates from your codebase land alongside them.
  • Repos — git checkouts attached from GitHub or GitLab.
  • Standards — markdown rules the agent reads (see Standards).
  • A team owner — every workspace belongs to one of your teams, picked at creation time.

Creating a workspace

From the sidebar workspace switcher, click Create Workspace. The dialog asks for two things:
  1. Team — the team that owns this workspace. Defaults to your first team.
  2. Workspace Name — free-text label (e.g. My Project).
Submit reads Create Workspace. After creation, attach repos from GitHub or GitLab — see Repo manager.

Switching between workspaces

The workspace switcher sits at the top of the sidebar. Opening it shows:
  • Workspaces — workspaces already cloned to this machine.
  • Available — workspaces from your team(s) that haven’t been cloned yet. Selecting one clones it.
  • Create Workspace and All Workspaces actions at the bottom.
The trash icon on a row removes that workspace from local storage only — the cloud copy stays, and you can re-clone it from Available.

Multiple windows

p0 supports up to 5 workspace windows open at once. From the switcher row, click the external-link icon to open a workspace in a new window. A purple dot on a row means that workspace is already open in another window. Clicking that row focuses the existing window instead of switching the current one.

All workspaces view

All Workspaces opens a full-screen picker with Local and Available tabs, a search box, and a New button. Local cards show the folder path under the workspace name; available cards show Cloud — click to clone. Removing a local workspace prompts: This will remove [name] from your local machine. The workspace will still be available from the cloud.