Reference

CLI quick reference

Use this page as your operational cheatsheet.

# Auth and root linkage (anywhere under a linked root)
looky login https://my.looky.studio <local_root>
looky whoami
looky logout

# Discovery and billing (run from <local_root> itself; the CLI rejects subdirs)
looky billing list
looky billing use <billing_account_id>
looky workspaces

# Create/pull/delete a workspace (run from <local_root>/<billing_account_id>)
looky pull <workspace_slug>
looky create <workspace_slug> --name "My Workspace" --description "..."
looky delete <workspace_slug> [--yes]

# First-time deploy of a new workspace: settings go up before content
looky push --settings        # runtime/** + secrets/**

# Build/publish loop (run from anywhere inside the workspace tree)
looky status
looky validate
looky validate --strict      # additionally checks each query against the live source
looky diff
looky push
looky push --strict          # push with the strict validation gate

# Runtime source checks (anywhere inside the workspace tree)
looky sources diff
looky sources list

# Published content checks (anywhere inside the workspace tree)
looky list visualizations
looky list dashboards

Command usage by phase

Day-zero onboarding

looky login → looky whoami → looky billing list/use

Start workspace work

looky pull or looky create → looky push --settings (new workspace only) → looky status → looky validate

Publish safely

looky diff → looky push → looky list dashboards/visualizations

Investigate source mismatch

looky sources diff and looky sources list

Placeholder conventions used in docs

• <local_root>: local root linked during looky login.
• <billing_account_id>: active billing account selected with looky billing use.
• <workspace_slug>: one workspace folder under the billing account.

Troubleshooting entrypoint

For symptom-driven fixes, continue with Troubleshooting. For per-adapter behavior differences, see Source adapter differences.