Skip to content

org ​

Organizations. Each Sibyl organization is an isolated tenant with its own SurrealDB namespace (org_<uuid_hex>). org lists organizations, creates them, switches the active org, and manages members.

Commands ​

CommandDescription
sibyl org listList organizations
sibyl org createCreate an organization
sibyl org switchSwitch the active organization
sibyl org membersManage organization members

Org Isolation ​

Every graph and memory operation is scoped to an organization. Switching orgs changes the namespace the CLI reads and writes. Membership roles (owner, admin, member, viewer) govern what a user can do inside an org.


org list ​

List the organizations you belong to, with your role in each and whether it is a personal or team org.

bash
sibyl org list [--json]
OptionShortDescription
--json-jJSON output

org create ​

Create a new organization. By default the CLI switches into the new org after creating it.

Synopsis ​

bash
sibyl org create --name <name> [options]

Options ​

OptionShortDefaultDescription
--name-n(req.)Organization name (required)
--slug(derived)Optional URL slug
--switchonSwitch into the org after creating it (--no-switch)

Example ​

bash
sibyl org create --name "Acme Engineering" --slug acme-eng

org switch ​

Switch the active organization by slug.

Synopsis ​

bash
sibyl org switch <slug>

Arguments ​

ArgumentRequiredDescription
slugYesOrganization slug

Example ​

bash
sibyl org switch acme-eng

org members ​

Manage organization members.

SubcommandDescription
sibyl org members listList all members of an org
sibyl org members addAdd a member to an org
sibyl org members removeRemove a member from an org
sibyl org members roleUpdate a member's role

Roles: owner, admin, member, viewer.

org members list ​

bash
sibyl org members list <slug> [--json]
ArgumentRequiredDescription
slugYesOrganization slug
OptionShortDescription
--json-jJSON output

org members add ​

bash
sibyl org members add <slug> <user_id> [options]
ArgumentRequiredDescription
slugYesOrganization slug
user_idYesUser ID to add
OptionShortDefaultDescription
--role-rmemberRole to assign

org members remove ​

bash
sibyl org members remove <slug> <user_id> [options]
ArgumentRequiredDescription
slugYesOrganization slug
user_idYesUser ID to remove
OptionShortDescription
--force-fSkip confirmation

org members role ​

bash
sibyl org members role <slug> <user_id> <role>
ArgumentRequiredDescription
slugYesOrganization slug
user_idYesUser ID
roleYesNew role: owner, admin, member, viewer

Examples ​

bash
# List members
sibyl org members list acme-eng

# Add a member as an admin
sibyl org members add acme-eng user_abc123 --role admin

# Promote a member to admin
sibyl org members role acme-eng user_abc123 admin

# Remove a member without a prompt
sibyl org members remove acme-eng user_abc123 --force

Released under the Apache-2.0 License.