Workspaces

Workspace folder is the delivery boundary

Looky CLI resolves context from your current directory. Wrong directory means wrong workspace identity, wrong billing context, and unreliable push results.

Required directory shape

<local_root>/
  <billing_account_id>/
    <workspace_slug>/
      workspace.yml
      content/
        models/
        visualizations/
        dashboards/
        exports/
      runtime/
        sources.runtime.yml
      secrets/

How to verify workspace context quickly

1. Move to workspace root:

   cd <local_root>/<billing_account_id>/<workspace_slug>

2. Run:

   looky status
   looky validate

3. Confirm workspace id is <billing_account_id>/<workspace_slug>.
4. Open workspace.yml and confirm id matches folder slug.

What breaks when structure is wrong

• looky validate may fail to resolve local workspace.
• looky push may target wrong workspace id.
• looky list dashboards may show unexpected workspace results.