Referencia

Quick reference del CLI

Usa esta página como tu cheatsheet operacional.

# 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/sources.runtime.yml + 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                 # aliases de sources, con la fecha de su última introspección
looky sources introspect <alias>   # actualiza el schema de esa source en tu workspace

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

Uso de comandos por fase

Onboarding día cero

looky login → looky whoami → looky billing list/use

Empezar trabajo de workspace

looky pull o looky create → looky push --settings (solo workspace nuevo) → looky status → looky validate

Publicar seguro

looky diff → looky push → looky list dashboards/visualizations

Investigar mismatch de source

looky sources diff, looky sources list y looky sources introspect <alias> — este último actualiza el schema contra el que están escritos tus modelos.

Convenciones de placeholders usadas en la doc

• <local_root>: local root linkeado durante looky login.
• <billing_account_id>: billing account activo seleccionado con looky billing use.
• <workspace_slug>: una carpeta de workspace bajo el billing account.

Entrypoint de troubleshooting

Para fixes por síntoma, sigue con Troubleshooting. Para diferencias de comportamiento por adapter, mira Diferencias entre adapters de source.