oi settings exposes the same configuration surfaces as the OpenIndex web UI. It is designed for human-owned credentials — Personal Access Tokens with read_write or admin scope. Workflow agent run tokens are intentionally rejected for all oi settings ... commands.
Do not use agent run tokens with oi settings. These commands require a PAT issued to a human user.
--help:
oi settings --help
oi settings personal --help
oi settings domain --help
oi settings external --help
oi settings admin --help
Personal settings
Manage your profile, access tokens, calendar sources, and workflow preferences.
oi settings personal profile get
oi settings personal profile update --display-name "Matt" --timezone-mode manual --timezone Australia/Perth
oi settings personal profile avatar upload --file ./avatar.png
oi settings personal tokens list
oi settings personal tokens create --name "local cli" --scope read_write
oi settings personal calendars list
oi settings personal calendars create --display-name "Personal" --source-url "https://example.com/calendar.ics"
oi settings personal workflows list
oi settings personal workflows fields list OPS
oi settings personal workflows providers list
Domain settings
Manage domains, their workflows, members, and lifecycle.
oi settings domain list
oi settings domain get OPS
oi settings domain create --key OPS --name "Operations"
oi settings domain workflows list --domain OPS
oi settings domain workflows get TRIAGE --domain OPS
oi settings domain workflows fields list TRIAGE --domain OPS
oi settings domain members list --domain OPS
oi settings domain delete-preview OPS
delete-preview shows what would be removed before you commit to deleting a domain. Review the output carefully before proceeding with a destructive operation.
External settings
Manage mailboxes, email routing rules, email provider configuration, domains, and webhooks.
oi settings external mailboxes list
oi settings external mailboxes routing-rules list support@company.com
oi settings external email provider get
oi settings external email domains list
oi settings external email domains provision --name support.example.com
oi settings external email webhooks list
Admin settings
Instance-level administration: branding, invites, admin users, user management, and AI provider configuration.
Admin commands require a PAT with admin scope. Using a read_write-scoped token will result in a permission error.
oi settings admin instance get
oi settings admin instance update --app-display-name "OpenIndex"
oi settings admin instance branding upload --file ./logo.png
oi settings admin invites send --email new.user@example.com
oi settings admin instance-admins list
oi settings admin users list --search matt
oi settings admin ai-providers list
oi settings admin ai-providers test openclaw-primary