Organizations¶

Manage organizations.

Aliases: organization, org, orgs

List Organizations¶

bnerd organizations list

Alias: ls

Lists all organizations you belong to. Only requires a token (no --org-id needed). For accounts with multiple memberships the list shows every organization you can reach.

Switch Active Organization¶

# Interactive menu (no argument)
bnerd org switch

# Switch directly by ID
bnerd org switch <org-id>

Saves the chosen organization as org-id in ~/.bnerd.yaml. Every subsequent request will carry ?organization_id=<org-id> so the API scopes data to that organization.

The command validates membership before saving: a non-member org-id is rejected (fail-closed). For single-org accounts the command still works — it just re-confirms the only available organization.

Get Organization Details¶

bnerd organizations get [org-id]

If no org-id is provided, uses the configured org-id.

Create Organization (admin only)¶

bnerd organizations create --name "My Organization" --account-id <account-id>

This command is admin-only and calls POST /admin/organizations. Non-admin accounts receive a 403 Forbidden error.

The --account-id identifies the owner account: an Admin membership for that account is minted alongside the new organization shell.

Flags¶

Update Organization¶

bnerd organizations update [org-id] [flags]

If no org-id is provided, uses the configured org-id. Accepts the same address flags as create.

Delete Organization¶

bnerd organizations delete <org-id>

Features¶

Manage organization feature flags.

Get Features¶

bnerd organizations features get [org-id]

Set Feature¶

bnerd organizations features set <key> <value> [org-id]

Examples¶

# List all organizations
bnerd org list

# Switch active org via interactive menu
bnerd org switch

# Switch directly to a known org-id
bnerd org switch org-abc123

# Get current org details
bnerd org get

# Create org (admin only) — mints an Admin membership for the owner account
bnerd org create --name "ACME Corp" --account-id acc-abc123

# Update name
bnerd org update --name "New Name"

# View features
bnerd org features get

TUI Equivalent¶

In the interactive TUI (bnerd x), use the :organizations or :org command.