Hosted Runner Dashboard

Operations Agent Usage Setup Tasks Workspace Chat
Dashboard refresh interval (browser-local preference; does not change runner heartbeat or job polling).
Loading registered runners…
▸ Dispatch Eligibility Check
Check which runners are eligible to dispatch a specific PromptArtifact — without dispatching. Enter an artifact ID to see required capabilities and per-runner eligibility.
▸ Runner Crash Recovery
Review interrupted runner work after a stale heartbeat. Restartable candidates can be manually requeued once the runner reconnects. No automatic restart ever occurs.
Click to load recovery candidates.
Hosted Runner Bootstrap
Runner Bootstrap
Prepared Runner Release
Runner version: 0.2.1
Prepared runner release: v0.2.1 (Quick Start requires published stable metadata)
Prepared artifact targets: Linux x64, Windows x64
Requires Node.js >= 20 on the target machine.
Quick Start — Windows / PowerShell
& ([scriptblock]::Create((irm https://runner.ao.phlow.dk/bootstrap.ps1))) -RunnerProfile code-agent
Downloads, verifies, and starts the code-agent profile in the current directory. No path argument is required.
Quick Start — Linux / Bash
bash -c "$(curl -fsSL https://runner.ao.phlow.dk/bootstrap.sh)" -- --runner-profile code-agent
Downloads, verifies, and starts the code-agent profile from the current shell. No path argument or URL-only startup is required.
Advanced — Linux / Bash behind Cloudflare Access
export CF_ACCESS_CLIENT_ID='<client-id>'; export CF_ACCESS_CLIENT_SECRET='<client-secret>'; bash -c "$(curl -fsSL https://runner.ao.phlow.dk/bootstrap.sh)" -- --api-base-url https://runner.ao.phlow.dk
Required when the API is behind Cloudflare Access. Do not share your client secret.
Safety Notice
Commands must be copied and run manually in your terminal. The browser does not start the runner directly. The bootstrap script downloads a verified runner binary to ~/.phlowao/runner/ outside your project directory. Quick Start selects code-agent explicitly for implementation work. Installed tools and updates never select code-agent automatically. Generic bootstrap without a profile remains readonly. Code-agent writes only in assignment-isolated managed worktrees and remains subject to approval, readiness, allowlist, and dispatch gates. SHA-256 verification is mandatory before installation or start; a mismatch or missing checksum fails closed. Do not share or embed your CF_ACCESS_CLIENT_SECRET value. Secure runner registration (invite tokens) is not yet available.
Binary Cache Location
~/.phlowao/runner/versions/<version>/ — versioned runner executables
~/.phlowao/runner/current — file containing the active version
~/.phlowao/runner/downloads/ — download staging
~/.phlowao/runner/logs/ — runner log files
~/.phlowao/config/ — runner configuration
~/.phlowao/state/ — runner state (runner ID cache)
Runner Flags
--runner-id <id> — Custom runner ID (default: derived from hostname/user/path)
--api-base-url <url> — Control plane API URL
--runner-name <name> — Runner display name
--runner-profile readonly|code-agent — Explicit local authority; readonly is default
--continuous — Run continuously (default)
--once — Run one job then exit
--skip-autodiscovery — Disable auto-discovery
--visible-terminal — Use visible terminal mode
--auto-update — Enable auto-update (default)
--no-auto-update — Disable auto-update
Environment Variables
PHLOWAO_API_BASE_URL — Default control plane API base URL
PHLOWAO_RUNNER_PROFILE — Explicit runner profile when no CLI flag is supplied
CF_ACCESS_CLIENT_ID — Cloudflare Access client ID
CF_ACCESS_CLIENT_SECRET — Cloudflare Access client secret
Assigning Repositories and Capabilities
Runners declare their repositories and capabilities via the heartbeat request. The runner process sends this data automatically when started.
Runner declarations are sent in the heartbeat JSON body:
  • capabilities — array of capability IDs
  • allowedRepos — array of repo mappings with repo, localPath, enabled
  • metadata — runner environment info