robodev

DocsSign in

Reference

CLI reference

Every robodev command.

Getting startedConnect a frontendStartersDatabaseDomainsFile-based APIsAuthEmailOrganizationsStorageSecretsPushSchedulesJobsDeployLocal developmentCLI reference

Package name: robodev. Tokens live in ~/.robodev/credentials.json. The current folder is linked via .robodev.

robodev auth

Opens the Starbase OAuth page, listens on a localhost callback, and stores access + refresh tokens.

robodev logout

Deletes ~/.robodev/credentials.json.

robodev whoami

Prints the signed-in email and user id.

robodev projects

Lists projects you can access as id, name, and API URL. Rename or delete a project from the dashboard if you are an organization admin.

robodev create [path] [--starter <id>] [--empty] [--org <id>]

Resolves a starter, then creates a Starbase project named after the folder, copies that starter, writes .robodev plus VITE_API_URL and VITE_PUBLIC_API_URL, deploys, and runs npm install at the project root. Space, Auth chat, and Marketplace also write a frontend block and try a local Vite build before deploy; a failed FE build still deploys schema + APIs. Those starters print bun next steps, not npm run dev. Refuses to overwrite an existing package.json, database.ts, or .robodev.

  • --starter <id> or --starter=<id> selects that starter and skips the prompt, even on a TTY.
  • --empty is an alias for --starter empty.
  • Passing --empty together with --starter (any id, including empty) exits 1 with Use either --empty or --starter, not both.
  • On a TTY without --starter or --empty, a numbered list of starters is shown. Accept a 1-based index or an id.
  • Without a TTY and without --starter or --empty, the starter is space so existing scripts keep working.
  • Unknown --starter, empty prompt, unknown number, or unknown id exits 1 with Valid ids: space, auth-chat, marketplace, backend, empty.
  • --org <id> or --org=<id> creates the project in that organization and skips the org prompt, even on a TTY. Allowed together with --starter or --empty.
  • On a TTY without --org, if you are an admin of two or more organizations, a numbered list of admin orgs is shown. Accept a 1-based index or an org id.
  • Without a TTY and without --org, or with exactly one admin org, the organization id is omitted so the API uses your oldest admin organization.
  • Unknown organization prompt, empty answer, or unknown id exits 1 and does not create a project. Developer-only memberships are not listed.
  • Unknown other create flags and a missing value after --starter or --org also exit 1. --empty=… is an unknown flag. --organization is not a flag.

Writes .robodev, VITE_API_URL, and VITE_PUBLIC_API_URL for an existing project. Preserves an existing frontend block or frontend: false. If frontend is absent and apps/fe/package.json exists, writes the default frontend block. Omit the id to pick from a list.

robodev deploy [--force]

Uploads the allowed project file tree (schema, APIs, jobs, and frontend files). When .robodev frontend is set, runs the local Vite build first and aborts on failure. After a successful apply, waits until the project host is live before printing App and Docs URLs. If the host does not become reachable within 30 seconds, the command fails without printing the success banner. Use --force to apply destructive schema changes without a prompt.

Environment

  • STARBASE_URL — control-plane API (default https://robodev.povio.dev).
  • STARBASE_FE_URL — browser UI for OAuth (defaults to STARBASE_URL).