droploft-workspace

# Droploft v2 CLI — Workspace Skill A **workspace** is the top-level tenant. Each user has one personal workspace by default and may belong to additional shared ones. Lofts and drops live inside a workspace. ## Layer 1 flows ```bash droploft workspace +list # workspaces you belong to (with role) droploft workspace +switch # interactive (TTY) droploft workspace +switch --workspace <id> # non-TTY ``` `workspace +switch` clears `profile.loft_id` — you must follow up with `loft +switch` (or pass `--loft` on each call). The hint is included in the response. ## Layer 2 resource verbs ```bash droploft workspaces list droploft workspaces navigation # GET /v1/me/navigation — workspaces with embedded lofts droploft workspaces members <workspace-id> droploft workspaces create --data '{"name":"Acme"}' droploft workspaces update <workspace-id> --data '{"name":"Acme Inc"}' ``` ## Roles `navigation` and `workspaces list` both return `role` per workspace: - `owner` — full control, can transfer or archive - `admin` — manage members + shared lofts - `member` — write within lofts they're added to - `guest` — read-only from invites ## Patterns ### Pin profile to a specific workspace + loft ```bash droploft workspace +switch --workspace <ws-id> droploft loft +switch --loft <loft-id> droploft config current # confirm ``` ### Inspect every loft in every workspace ```bash droploft workspaces navigation --format json --jq '.workspaces[].lofts[]' ``` ## Errors - Switching to a workspace you no longer belong to → `not_found` (exit 4). Re-list and retry. - `members` requires being in the workspace.