Docs / Getting Started

Sign In and Connect the CLI

Sign in to cloud first

Start in https://my.looky.studio and complete OTP login before touching CLI. This confirms your role and account access independently from local machine state.

  1. Open https://my.looky.studio.
  2. Authenticate with email OTP.
  3. Confirm shell loads without access errors.

Link CLI to the same instance and local root

The CLI stores authentication and billing context per linked root. Pick one stable root folder and keep using it.

looky login https://my.looky.studio <local_root>
looky whoami

If your CLI asks for email during login, provide the same identity you used in UI.

Activate billing context from root

cd <local_root>
looky billing list
looky billing use <billing_account_id>

Run billing commands from the linked root itself. Billing context is root-scoped and must be set before workspace operations.

Verify context before workspace actions

  1. From <local_root>/<billing_account_id>/<workspace_slug>, run looky status.
  2. Confirm workspace id resolves as <billing_account_id>/<workspace_slug>.
  3. Run looky validate and confirm no blocking errors.

Cloud and local runtime parity

Cloud (my.looky.studio) is your shared target. Local runtime (http://localhost:8000) is optional for quick iteration and debugging. Use both for verification when needed.

If cloud and local differ, start with looky status and looky diff in the workspace root. Most mismatches are context or sync issues, not chart bugs.