# Wheelie full public docs bundle Agent docs index: /llms.txt This bounded bundle repeats the launch-preview one-afternoon path and links to the markdown pages that should remain fetchable without page chrome. The path starts from an existing checkout or public repo, uses a BYO harness when projection install is adapter-gated, produces one reviewable diff, and runs focused validation evidence. Adapter-, allowlist-, preview-, fixture-, and evidence-gated rows are not broad green launch claims. ## Public pages - /llms.txt - /waitlist - /changelog - /status - /docs/wheelie/index.html - /docs/wheelie/index.md - /docs/wheelie/quickstart.md - /docs/wheelie/cli.md - /docs/wheelie/command-taxonomy.md - /docs/wheelie/wait-guard.md - /docs/wheelie/better-than-found.md - /docs/wheelie/platform-capabilities.md - /docs/wheelie/device-realtime-capabilities.md - /docs/wheelie/edge-capability-apps.md - /docs/wheelie/private-repos.md - /docs/wheelie/support-levels.md - /docs/wheelie/support-state-matrix.md - /docs/wheelie/support.md - /docs/wheelie/byok-secrets.md - /docs/wheelie/billing.md - /docs/wheelie/spend-support-states.md - /docs/wheelie/paid-proof-quote.md - /docs/wheelie/community-contributions.md - /schemas/wheelie/public-command-manifest.json - /services/wheelie/support-state-matrix.json - /services/wheelie/feature-discovery.json - /services/wheelie/public-discovery-manifest.json - /services/wheelie/launch-hostname-matrix.json - /services/wheelie/changelog.json - /services/wheelie/package-gallery.json - /services/wheelie/community-contribution-policy.json - /services/wheelie/artifacts/wheelie-capability-kit/status.json - /services/wheelie/capacity-waitlist-handoff.json - /schemas/wheelie/feature-discovery.openapi.json - /schemas/wheelie/paid-proof-quote.openapi.json - /schemas/wheelie/better-than-found-receipt.schema.json - /assets/wheelie/brand/manifest.json ## Static brand metadata Wheelie human-facing docs use `/docs/wheelie/index.html` for favicon, canonical URL, Open Graph, Twitter card, and a static hero image. The semantic asset mapping lives at `/assets/wheelie/brand/manifest.json`; images are not required to understand or execute the agent docs. ## First-run path 1. Install Wheelie and run doctor. 2. Sign in with device/browser auth. 3. Connect GitHub/source and model credentials, then check whether each selected credential path reports mediated, short-lived, or raw env/file projection mode. 4. Probe Pi, Claude, or Codex harness projection support; clean public stable may return `requires_adapter` until a richer package or project adapter is attached. 5. Fetch bounded startup context. 6. Create a work item and request a working-copy/harness handoff; live materialization requires supported source access and may return allowlist or adapter-required support states. Private/non-public GitHub repositories are launch-deferred until a mediated source-provider adapter or allowlist receipt is attached for the selected repo. 7. Run local validation, inspect evidence, and use submit/watch/checkpoint only when the matching change/checkpoint adapters report live support. 8. Check resource usage and run cleanup as a dry-run before deleting anything. Canonical commands: ```bash brew install cosign curl -fsSL https://get.wheelie.dev -o wheelie-install.sh sh wheelie-install.sh export PATH="$HOME/.wheelie/bin:$PATH" wheelie version --json wheelie doctor --json wheelie auth login wheelie auth status --json wheelie integration connect github --repo octocat/Hello-World --json wheelie source status --repo octocat/Hello-World --json wheelie models status --credential-mode subscription --json wheelie models list --credential-mode subscription --json wheelie auth login --provider # For app capabilities and generated-app guidance, read https://wheelie.dev/docs/wheelie/platform-capabilities.md wheelie capability list --scope platform --json wheelie capability inspect platformd://queue-lease/claim --json # For device/browser/realtime resources, read https://wheelie.dev/docs/wheelie/device-realtime-capabilities.md first. # For apps that declare installed-client capabilities, read https://wheelie.dev/docs/wheelie/edge-capability-apps.md first. wheelie capability list --scope resources --json wheelie capability inspect device://local/android/ --json # For BYOK/model secrets, first read https://wheelie.dev/docs/wheelie/byok-secrets.md wheelie harness install pi --dry-run --json # clean public stable may return requires_adapter wheelie harness status pi --json wheelie context pack --purpose coding --level startup --json wheelie work create --title "Update the README greeting" --json wheelie work open-working-copy wheelie://work-items/ --repo / --launch pi --json # If support_state=requires_adapter and agent_session=null, this is working-copy handoff only; keep using your BYO harness. wheelie validation plan --json wheelie validation run --only local-git-working-copy-smoke --json wheelie change status --change --json wheelie submit --change --dry-run --json # After reviewing the admission preview and any policy/human gates: wheelie submit --change --apply --json wheelie watch --change --cursor --max-wait-secs 900 --ndjson wheelie checkpoint create --message "ready for handoff" --work-item wheelie://work-items/ --context-file handoff.md --json # if checkpoint store is attached wheelie resources status --json wheelie working-copy gc --dry-run --json ``` ## Support level rules - Launch support starts from `/docs/wheelie/support.md`; agents should share typed `reason`, `support_state`, `next_action`, retry, operation/evidence refs, and redacted support-bundle fields instead of raw terminal logs, provider dashboards, private source, or secrets. - Native means the public launch-preview path is intended to work for the documented supported scope. - Projection/BYO means the one-afternoon loop can use Pi, Claude Code, or Codex that the user already runs; a richer package or project adapter can install token-free harness instructions, but clean public stable may report `requires_adapter` instead of mutating files. - Preview/requires-adapter means the command may be visible, but it must return typed support and next-action fields when an adapter is missing, including private/non-public GitHub repo source mediation. - Slack mediated read/write is `hosted_preview`: use the public Add to Slack URL for user-owned workspaces only (`app_id=A0B7RHMEFU5`), then require live workspace/channel/token-custody receipts and redacted telemetry before launch-green claims. Do not use Continua private Slack as a fallback. - BYOK/model secrets are encrypted/write-only in storage, but usage must label mediated, short-lived, or raw env/file projection mode. - Allowlist means access needs an explicit project, budget, credential, or capacity grant. - Fixture-only means agents may inspect the contract and run no-money demos, but must not imply payment support or provider payments. - Billing/payment for the private preview is manual invoice or contract only. Plan changes, overage, cancellation, credits, refunds, and disputes route through support; there is no self-serve checkout, card charge, billing portal, automatic overage, or money movement in the Wheelie launch path. Spend copy must use `/docs/wheelie/spend-support-states.md`. - Unsupported means agents should not plan on the surface. - Internal means the surface is not part of public launch docs. ## Machine-readable links - Waitlist: /waitlist with typed `pilot_source=marketing_private_preview|capacity_overflow|manual_invite_interest`; use `?reason=capacity` for capacity-overflow handoff. - Command manifest: /schemas/wheelie/public-command-manifest.json - Support-state matrix: /services/wheelie/support-state-matrix.json and /docs/wheelie/support-state-matrix.md - Command taxonomy: /docs/wheelie/command-taxonomy.md for `app`, `instant`, `agent`, `agent-run`, and `models` support-state boundaries. - Wait guard: /docs/wheelie/wait-guard.md - Platform capabilities: /docs/wheelie/platform-capabilities.md - Device, browser, and realtime capabilities: /docs/wheelie/device-realtime-capabilities.md - Edge capability apps: /docs/wheelie/edge-capability-apps.md - Spend support states: /docs/wheelie/spend-support-states.md - BYOK and secrets guide: /docs/wheelie/byok-secrets.md - Private/non-public GitHub repositories: /docs/wheelie/private-repos.md - Launch support and friendly error states: /docs/wheelie/support.md - Feature-discovery catalog: /services/wheelie/feature-discovery.json - Public discovery manifest: /services/wheelie/public-discovery-manifest.json with owners, canonical URLs, index/noindex posture, release paths, and support-state inventory for public LLM/developer discovery resources. - Launch hostname matrix: /services/wheelie/launch-hostname-matrix.json with public control-plane IA. `wheelie.dev` is the root waitlist plus docs/device handoff, `get.wheelie.dev` is install/release distribution, hosted browser/API backing origins are labeled in the matrix by support state, and normal receipts should prefer `wheelie://` logical refs for work, working copies, agent runs, VMs, validation/evidence, source/changes, and checkpoints. - Public changelog task projection: /services/wheelie/changelog.json - Package gallery: /services/wheelie/package-gallery.json with descriptor/fake-provider cards and explicit non-green support states unless live package readbacks exist. - Community contribution policy: /docs/wheelie/community-contributions.md and /services/wheelie/community-contribution-policy.json. - Capability Kit status/readback metadata: /status and /services/wheelie/artifacts/wheelie-capability-kit/status.json; these routes are readback surfaces. They may claim npm latest and GitHub readback when backed by receipts, label Wheelie Source npm-marker reconciliation as pending until the runtime route matches, and they do not claim live transport, hosted production grants, broad marketplace availability, payouts, live money, or production support. - Capacity waitlist handoff fixture: /services/wheelie/capacity-waitlist-handoff.json - Feature-discovery OpenAPI schema: /schemas/wheelie/feature-discovery.openapi.json - Paid validation quote OpenAPI fixture: /schemas/wheelie/paid-proof-quote.openapi.json - Private-preview billing boundary: /docs/wheelie/billing.md - Not-green public claims: full clean onboarding-to-PR, stable-artifact mutating-auth fix before a public smoke passes, private/non-public GitHub repository attach without a mediated adapter receipt, strong workspace/context durability, public named-workspace lifecycle/durability timing, broad performance/capacity/pricing/prod-parity numbers outside the next-launch public scope, arbitrary-user provider-backed submit/watch, and self-serve billing/payment flows. Do not cite warm-resume/cold-boot/first-setup p50/p95/p99, same-session reconnect, preview/share URL continuity, process/log continuity, cleanup SLO, host-loss, or dirty partial-run auto-recovery without public/customer-facing named-workspace cohort receipts. Only narrow, bounded staging proof-wave facts may be cited with their stated limits. - Agent-readable surface doctrine: `/docs/wheelie/support-levels.md` defines API-first, browser-mediated fallback, links-only, and support-only modes; agents should branch on typed receipts rather than browser automation, screenshots, raw provider dashboards, or prose logs. - Expected JSON failure fields: `schema_version`, `support_state`, `reason`, `next_action`, `blockers`, `work_item_ref`, `working_copy_id`, `receipt`, `cursor`. - Quote safety fields: `money_movement_enabled`, `evidence_record_schema_ref`, `required_budget_authorization_fields`. - Expected streaming mode: bounded NDJSON with `cursor` and `max_wait_secs` style controls.