Skip to main content
These families administer the workspace itself. Several are owner/admin only, enforced server-side. Add --json to any command for machine output. For login, doctor, install-skill, and sync, see CLI Setup; for workspace switching, see Context commands.

Members

CommandDescription
member listList members (id, role, email).
member invite <email> [--role admin|member]Invite a member. owner cannot be invited.
member role <memberId> <role>Set a member’s role: owner, admin, or member.
member rm <memberId>Remove a member.
member invitesPending invites.
Member writes are owner/admin actions. Roles are owner, admin, member; invites may only grant admin or member.
driftless member invite dev@acme.com --role member
driftless member role mem_123 admin

Areas and tags

CommandDescription
area listList areas (the domains topics file under).
area add <name> [--description "..."]Create an area.
area rename <id> <new-name>Rename an area (owner/admin).
area rm <id>Delete an area; its topics become unfiled (owner/admin).
Tags are covered under Context commands: tags, tags add, tags rename, tags rm. Renaming and deleting an area or tag are owner/admin curation acts.

Repositories and branches

CommandDescription
repo listLinked repositories.
repo link <org/repo>Link a GitHub repository (must be in org/repo form).
repo unlink <id>Unlink a repository.
branchesList tracked branches.
branches add <branch>Track a branch (requires a git repo and a linked repo).
branches rm <branch>Untrack a branch.
The default branch is always tracked; branches add/rm change the extra tracked branches used for push-driven drift.
driftless repo link acme/api
driftless branches add staging

Notes

CommandDescription
note add --content "..."Capture a private note. --content accepts @file.
--project <id> attaches the note to a project; --card <id> (which requires --project) attaches it to a card mid-loop. --allow-secrets and --json are available. A note is always private to you.

Audit and export

CommandDescription
audit log [--limit <n>]The workspace audit trail (owner/admin).
Workspace export is an owner/admin capability, but the export endpoint requires a human dashboard session, so run it from the dashboard rather than an API-key CLI call.
  • Workspaces - roles, membership, and scoped keys.
  • Areas - how topics are filed.