Skip to content
DunSocial Docs

Workspaces

List workspaces and set the default for dun commands.

Most commands need a workspace. Set a default once, or pass --workspace / DUN_WORKSPACE_ID on each command.

List workspaces

dun workspace list
dun workspace list --json

Shows id, name, slug, your role, timezone, and plan status.

Set the default

dun workspace use your-workspace-slug
# or
dun workspace use WORKSPACE_ID

This writes the default into ~/.config/dunsocial/config.json.

Show the current workspace

dun workspace current
dun workspace current --json

If nothing is selected, you will get a validation error asking you to run workspace use.

Override for one command

dun posts list --workspace WORKSPACE_ID
# or
export DUN_WORKSPACE_ID=WORKSPACE_ID

workspaces is an alias of workspace.