droploft-workspace

name	droploft-workspace
version	0.2.0
description	Workspaces: switching, listing, members, navigation tree.
metadata	{"requires":{"bins":["droploft"],"skills":["droploft-shared"]},"cliHelp":"droploft workspace --help"}

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

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

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

droploft workspace +switch --workspace <ws-id>
droploft loft +switch --loft <loft-id>
droploft config current      # confirm

Inspect every loft in every workspace

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.