Skip to content
⌘K

Command reference

okibi auth

Log in, log out, and connect accounts

Generated from okibi 0.2.4. Every command also takes the global flag --agent.

Usage
okibi auth [command]

Commands

githubConnect your GitHub account (install the Okibi GitHub App)
loginLog in to Okibi in your browser (or --api-key for CI)
logoutRemove this machine's stored Okibi key
publisherConnect the GitHub publisher app to publish into your account or organization
signupCreate an Okibi account and log this machine in (via GitHub)
statusShow who you're logged in as

okibi auth github

Connect your GitHub account (install the Okibi GitHub App)

Usage
okibi auth github [flags]
okibi auth github [command]

Commands

manageOpen one account's GitHub App settings to change repository access or uninstall
remove-repoRemove one repository from a selected-repository GitHub installation
statusRefresh GitHub installations and show account access and management links

Flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai
--workspacestringworkspace to refresh (or OKIBI_WORKSPACE; default: this machine's default workspace)

okibi auth github manage

Open one account's GitHub App settings to change repository access or uninstall

Usage
okibi auth github manage <account> [flags]

Flags

FlagTypeDescription
--no-browserboolprint the management URL without opening a browser

Inherited flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai

okibi auth github remove-repo

Remove one repository from a selected-repository GitHub installation

Usage
okibi auth github remove-repo <owner/repository> [flags]

Flags

FlagTypeDescription
--jsonboolemit JSON
--workspacestringworkspace slug (or OKIBI_WORKSPACE)
--yesboolconfirm repository access removal

Inherited flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai

okibi auth github status

Refresh GitHub installations and show account access and management links

Usage
okibi auth github status [flags]

Flags

FlagTypeDescription
--jsonboolemit JSON

Inherited flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai

okibi auth login

Connects this machine to your Okibi account. By default a browser opens and returns automatically to this terminal after approval; the minted machine key lands in the OS keyring (config-file fallback). SSH/headless sessions use device-code login automatically; --device-code forces that flow, and --api-key stores an existing key for CI. No account yet? okibi auth signup.

Usage
okibi auth login [flags]

Flags

FlagTypeDescription
--api-keystringstore an existing Okibi API key instead of the browser flow
--api-urlstringpersist a non-default API URL (e.g. a local dev server)
--device-codebooluse the device-code flow for remote or headless login

okibi auth logout

Remove this machine's stored Okibi key

Usage
okibi auth logout [flags]

Flags

FlagTypeDescription
--api-urlstringignored — logout only clears local state

okibi auth publisher

Connect the publisher app in your browser using the same Okibi account. Follow the browser prompts to connect GitHub. Organization connections require an org owner. Agent mode returns an approval URL without waiting.

Usage
okibi auth publisher [flags]
okibi auth publisher [command]

Commands

statusCheck GitHub publisher access and list connected accounts

Flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai
--no-browserboolprint the approval URL without opening a browser
--timeoutdurationmaximum time to wait for browser approvaldefault 5m0s

okibi auth publisher status

Check GitHub publisher access and list connected accounts

Usage
okibi auth publisher status [flags]

Flags

FlagTypeDescription
--jsonboolprint JSON

Inherited flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai

okibi auth signup

Opens your browser to create an Okibi account with GitHub and returns automatically to this terminal; the minted machine key lands in the OS keyring (config-file fallback). This is the same flow as okibi auth login. Remote and headless sessions switch to device-code login automatically; --device-code forces it. GitHub signs you up if you're new.

Usage
okibi auth signup [flags]

Flags

FlagTypeDescription
--api-urlstringpersist a non-default API URL (e.g. a local dev server)
--device-codebooluse the device-code flow for remote or headless login

okibi auth status

Show who you're logged in as

Usage
okibi auth status [flags]

Flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai