Multiple Projects

Each xpo init creates an independent .xpo/ directory in that repo. You can run as many projects as you want — each has its own backlog, configuration, and ID prefix.

ID prefixes

Every project gets a unique prefix so issue IDs don't collide:

# repo-a/.xpo/config.yaml
prefix: api-

# repo-b/.xpo/config.yaml
prefix: web-

Issues become api-1, api-2, web-1, web-2, etc.

Multi-project sidebar

Run xpo board from any number of projects in parallel. Every running instance registers in a shared local registry, and the sidebar lists all live boards as one-click destinations.

# Terminal 1
cd ~/projects/api && xpo board

# Terminal 2
cd ~/projects/web && xpo board -p 8081

Both boards appear in each other's sidebar. Click to switch between projects without leaving the browser.

If port 8080 is already in use, xpo picks the next free port automatically.

Project display name

Set a name for the sidebar:

name: API Service