# Wheelie public docs Agent docs index: /llms.txt Wheelie is Continua's public Development OS for agentic coding work. These docs describe the launch-preview first-run path and label everything else by support level. Adapter-, allowlist-, preview-, fixture-, and evidence-gated rows are not broad green launch claims. ## Start here - [Wheelie docs landing page](https://wheelie.dev/docs/wheelie/index.html): human-facing docs entry with Wheelie-specific favicon and Open Graph metadata; agents do not need images for comprehension. - [Wheelie quickstart](https://wheelie.dev/docs/wheelie/quickstart.md): install Wheelie, sign in, connect GitHub/model access, install a Pi/Claude/Codex harness projection, fetch fast context, create work, use a working copy, run validation, submit/watch, checkpoint, and check resources. - [Wheelie CLI support map](https://wheelie.dev/docs/wheelie/cli.md): public command families and support levels. - [Wheelie support levels](https://wheelie.dev/docs/wheelie/support-levels.md): definitions for native, preview, allowlist, roadmap, unsupported, and internal surfaces. - [Wheelie launch support and friendly error states](https://wheelie.dev/docs/wheelie/support.md): support owner/response path, Discord pinned guidance, safe support-bundle fields, stop conditions, and typed runbooks for capacity, BYOK, source auth, validation, PR/change, preview, budget, and stuck-task failures. - [Wheelie BYOK and secrets guide](https://wheelie.dev/docs/wheelie/byok-secrets.md): encrypted/write-only credential storage, mediated vs raw projection support levels, and revocation caveats. - [Wheelie private-preview billing](https://wheelie.dev/docs/wheelie/billing.md): manual invoice or contract billing only; no self-serve checkout, card charge, billing portal, automatic overage, or live-money rail in the launch path. - [Wheelie paid validation quote prototype](https://wheelie.dev/docs/wheelie/paid-proof-quote.md): fixture-only agent quote contract for future paid validation services; no live money enabled. - [Wheelie public command manifest](https://wheelie.dev/schemas/wheelie/public-command-manifest.json): machine-readable first-run commands and visible non-MVP support labels. - [Wheelie feature-discovery catalog](https://wheelie.dev/services/wheelie/feature-discovery.json): typed capabilities, support levels, actions, cooldown policy, and metrics for low-noise CLI/web suggestions. - [Wheelie feature-discovery API schema](https://wheelie.dev/schemas/wheelie/feature-discovery.openapi.json): provider-neutral request/response shape for personalized feature suggestions without raw command arguments, source paths, or secrets. - [Wheelie brand asset manifest](https://wheelie.dev/assets/wheelie/brand/manifest.json): semantic mapping for docs/static favicon, hero, avatar, and social-preview images. ## First-run command sequence ```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 list --credential-mode subscription --json wheelie auth login --provider # For BYOK/model secrets, first read https://wheelie.dev/docs/wheelie/byok-secrets.md wheelie harness install pi --apply --json # or claude, codex, all wheelie harness status --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 wheelie validation plan --json wheelie validation run --only local-git-working-copy-smoke --json wheelie change status --change --json wheelie submit --change --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 summary - Support: use `/docs/wheelie/support.md` before asking for raw logs. Share typed `reason`, `support_state`, `next_action`, operation/evidence refs, cursors, and redacted support-bundle fields with support@continua.ai or the private-preview Discord channel named in the invite packet. - Native: install/update/doctor/version command shape, auth status probes, Pi harness projection, fast context packs, local work items, local read-only resources status, and typed feature-discovery hints with client-side cooldowns/dismissals. Managed VM quota, provider quota, billable usage ledger, model catalog/credential operations, and validation are green only after the relevant project, billing, model, source, or validation adapter reports live support for the current account/working copy. BYOK/model secrets are encrypted/write-only in storage, but usage must label mediated, short-lived, or raw env/file projection mode. - Projection/BYO: Claude Code and Codex harness projections can be installed when you bring the corresponding harness; they are not one-click managed native harness claims. - Preview/requires adapter: commands that need richer model, project/source, private-repo source-provider mediation, hosted workspace, agent-run, validation, change/PR, or checkpoint adapters before live effects are available. They should return typed `support_state`, `reason`, and `next_action` fields. - Fixture-only: paid validation quote discovery exists for agent planning, but it must report `live_money_enabled=false` and use `next_action=run_no_money_demo` or `unsupported` unless a future budget contract is attached. - Billing: private-preview Wheelie billing is manual invoice or contract only. Plan changes, overage, cancellation, credits, and refunds go through support; there is no self-serve checkout, card charge, billing portal, automatic overage, or live-money rail in the launch path. - Allowlist: launch-preview browser/device auth, the approved GitHub sample-repo adapter path, spendful managed workspaces, stable-artifact auth smoke, and selected integration adapters. - Public source sample: `wheelie source status --repo octocat/Hello-World --json` is the clean launch source-materialization smoke. Private and other non-public GitHub repos remain out of the clean public launch path until the mediated source-provider adapter/allowlist path is attached for the selected repo; if a selected repo returns `source_provider_adapter_required`, use a public GitHub repo or attach the mediated adapter, and do not paste raw provider tokens. - Not green yet: the full clean public onboarding-to-PR loop, hosted model/workspace/agent-run/validation/PR path from a clean public install, strong workspace/context durability, broad performance/capacity/pricing/prod-parity numbers, provider-backed submit/watch for arbitrary public users, and self-serve billing. Broad performance/capacity/pricing/prod-parity claims stay outside the next-launch public scope; only narrow, bounded staging proof-wave facts may be cited with their stated limits. - Roadmap: capability marketplace, generic webhooks/bots, edge or heavy GPU workers, commerce, and ticketing. - Unsupported: raw provider admin, unmediated secret passing outside an explicitly labeled raw-projection mode, and private project admin workflows. ## Agent retrieval contract Agents should fetch this file first, then the quickstart and command manifest. The quickstart contains expected outputs and next actions. Programs should key off JSON fields such as `schema_version`, `schemaVersion`, `support_state`, `reason`, `next_action`, `work_item_ref`, `working_copy_id`, `receipt`, `cursor`, and paid-quote fields like `live_money_enabled` and `evidence_record_schema_ref`, not human prose.