Pi Dash Cloud Quickstart
1. Sign up#
- Open https://pidash.airepublic.com.
- Click Sign up, complete sign-up, verify your email.
2. Create workspace + project#
- Create your workspace when prompted.
- Projects → + Add project. Fill in:
- Name, Identifier
- Repository URL — git clone URL (e.g.
git@github.com:acme/web.git) - Default branch — usually
main
- Open Project → Settings → General and copy the project ID.
3. Install an AI agent#
Pick one:
- Claude Code — install per https://docs.anthropic.com/en/docs/claude-code, verify
claude --version. - Codex — install per https://github.com/openai/codex, verify
codex --version.
4. Install pidash#
macOS / Linux:
curl --proto '=https' --tlsv1.2 -LsSf \
https://github.com/The-AI-Republic/pi-dash/releases/latest/download/install.sh | shWindows (PowerShell):
irm https://github.com/The-AI-Republic/pi-dash/releases/latest/download/install.ps1 | iexThe installer goes straight into the device-code flow against https://pidash.airepublic.com — approve it in the browser.
(Self-hosting instead? Cancel with Ctrl-C before approving, then run pidash auth login --url <YOUR-URL>.)
5. Register this machine as a runner#
pidash runner add --project <PROJECT_ID>
pidash doctor
pidash statuspidash doctor must be clean before continuing.
6. Run your first work item#
- In Pi Dash, Work items → + Create work item.
- Write a specific title + description + acceptance criteria.
- Click Run agent.
- Watch in the work item’s Run panel or
pidash tui. - Approve prompts as they appear (use Approve always for safe commands).
7. Review#
- Open the work item → review diff, transcript, summary.
- To commit:
cdinto the runner working dir (pidash statusshows the path), thengitas normal.
Common commands#
pidash status # daemon + runner state
pidash tui # interactive dashboard
pidash doctor # preflight checks
pidash auth status # who am I logged in as
pidash runner list # runners on this host
pidash runner add --project <ID>
pidash runner remove <name>
pidash restart / stop
pidash update --restart # self-update and restart when idle
pidash --helpFull command + flag reference: 17 — pidash CLI reference.
If something breaks#
- Run stuck pending →
pidash status, thenpidash restart. - Run fails immediately →
pidash doctor(usually agent not onPATH, or git clone auth). - Command not found → open a new terminal.
- Browser auth not approving → use the same browser you signed up in.
- Headless host → run
pidash auth login --no-browser, approve the printed URL from another browser, then runpidash runner add --project <PROJECT_ID>. Add--url <YOUR-URL>if you self-host.
Discussions: https://github.com/The-AI-Republic/pi-dash/discussions · Bugs: https://github.com/The-AI-Republic/pi-dash/issues