Installation

Quick install

curl -fsSL https://getxpo.dev/install.sh | bash

Detects your OS and architecture, downloads the latest binary from GitHub, and installs it to /usr/local/bin (or ~/.local/bin if not writable).

Binary download

Grab the latest release for your platform from GitHub Releases and put it on your PATH.

Go install

go install github.com/palarix/exponential/cmd/xpo@latest

Requires Go 1.25+. This builds the CLI without the embedded web UI. For the full build (CLI + web board), build from source.

From source

Requires Go 1.25+ and bun.

git clone https://github.com/palarix/exponential.git
cd exponential
make && make install

make builds the frontend assets and the Go binary. make install copies the resulting xpo executable to /usr/local/bin/xpo (it will ask for sudo permission).

Docker

docker build -t xpo:latest .
docker run -v /path/to/repo:/data -p 8080:8080 xpo:latest

The image runs xpo serve by default — see Distributed Mode for details.

Initialize a project

Run this once, inside any project directory:

cd path/to/your/project
xpo init

This creates a .xpo/ directory alongside your code. If the project is a git repository, your issues get full git integration — branching, merging, and versioning. But xpo init works in any directory.

Run the doctor

After initializing, run the doctor to validate your setup and generate agent instruction files:

xpo doctor

The doctor checks for common issues — missing config fields, stale schema versions, broken references — and offers to fix them. It also sets up AI agent instruction files so that coding agents working in your repo know how to use xpo.

Configure for AI agents

If you're working with AI coding agents, two more setup steps will make the experience seamless:

• MCP Server — wire up the MCP server so agents can manage issues through structured tool calls
• AI Agents — set up CLAUDE.md, agent identity, and the autonomous drive loop

Shell completion

Generate autocompletion for your shell:

xpo completion bash   # also: zsh, fish, powershell

Follow the printed instructions to install the completion script. This gives you tab-completion for commands, flags, and issue IDs.