Markdown

Pi Dash Cloud Quickstart

1. Sign up#

  1. Open https://pidash.airepublic.com.
  2. Click Sign up, complete sign-up, verify your email.

2. Create workspace + project#

  1. Create your workspace when prompted.
  2. Projects → + Add project. Fill in:
    • Name, Identifier
    • Repository URL — git clone URL (e.g. git@github.com:acme/web.git)
    • Default branch — usually main
  3. Open Project → Settings → General and copy the project ID.

3. Install an AI agent#

Pick one:

4. Install pidash#

macOS / Linux:

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/The-AI-Republic/pi-dash/releases/latest/download/install.sh | sh

Windows (PowerShell):

irm https://github.com/The-AI-Republic/pi-dash/releases/latest/download/install.ps1 | iex

The 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 status

pidash doctor must be clean before continuing.

6. Run your first work item#

  1. In Pi Dash, Work items → + Create work item.
  2. Write a specific title + description + acceptance criteria.
  3. Click Run agent.
  4. Watch in the work item’s Run panel or pidash tui.
  5. Approve prompts as they appear (use Approve always for safe commands).

7. Review#

  1. Open the work item → review diff, transcript, summary.
  2. To commit: cd into the runner working dir (pidash status shows the path), then git as 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 --help

Full command + flag reference: 17 — pidash CLI reference.

If something breaks#

  • Run stuck pending → pidash status, then pidash restart.
  • Run fails immediately → pidash doctor (usually agent not on PATH, 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 run pidash 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

Search Docs and Blog