Skip to content
⌘K

Command reference

okibi clis

Manage CLI projects, releases, testing, installs, and distribution

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

Manage the complete lifecycle of a CLI project.

Run without a subcommand to list projects. Every management command supports --workspace and --agent; --agent emits JSON and disables interactive input. Deletion is the deliberate exception: it always requires a human terminal.

Usage
okibi clis [flags]
okibi clis [command]

Also available as projects

Commands

analyticsOpt in to anonymous command analytics independently of Identity
changesCheck for repository commits since the last published version
deletePermanently delete a CLI (human confirmation required)
domainManage the branded install domain
endpointInspect or publish the API endpoint compiled into a CLI
feedbackRead the CLI feedback inbox
hostingConfigure where a CLI is hosted and who can install it
identityEnable or disable Okibi Identity for a CLI
insightsShow Identity usage, anonymous command reports, and installer metrics
installPrint a signed install command for one exact historical run
mcpConfigure hosted MCP clients and manage your connections
npmSet up npm publishing for a CLI's official releases
project-nameSet a CLI's project/display name without renaming its binary
publishPublish repository changes as the next version without promoting it
releaseSelect or clear the official release
releasesList the immutable release history
renameRename a CLI everywhere, including its hosted repository
showShow the important state of one CLI
skillRead, edit, and release the canonical SKILL.md
testingSelect existing versions and manage private tester access

Flags

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

okibi clis analytics

Opt in to anonymous command analytics independently of Identity

Usage
okibi clis analytics [command]

Inherited flags

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

okibi clis analytics disable

Usage
okibi clis analytics disable <cli> [flags]

Inherited flags

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

okibi clis analytics enable

Usage
okibi clis analytics enable <cli> [flags]

Inherited flags

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

okibi clis analytics status

Usage
okibi clis analytics status <cli> [flags]

Inherited flags

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

okibi clis changes

Check for repository commits since the last published version

Usage
okibi clis changes <cli> [flags]

Inherited flags

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

okibi clis delete

Permanently delete a CLI and its Okibi-managed history.

This command always opens the controlling terminal and requires the CLI name to be typed exactly. It has no --yes escape hatch and refuses --agent mode.

Usage
okibi clis delete <cli> [flags]

Inherited flags

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

okibi clis domain

Manage the branded install domain

Usage
okibi clis domain [command]

Commands

addAttach and verify a branded install hostname
removeDetach the branded install domain
statusShow domain, DNS, and verification state
verifyRe-check DNS and certificate readiness

Inherited flags

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

okibi clis domain add

Attach and verify a branded install hostname

Usage
okibi clis domain add <cli> <hostname> [flags]

Inherited flags

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

okibi clis domain remove

Detach the branded install domain

Usage
okibi clis domain remove <cli> [flags]

Inherited flags

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

okibi clis domain status

Show domain, DNS, and verification state

Usage
okibi clis domain status <cli> [flags]

Inherited flags

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

okibi clis domain verify

Re-check DNS and certificate readiness

Usage
okibi clis domain verify <cli> [flags]

Inherited flags

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

okibi clis endpoint

Inspect or change the API base URL compiled into the official CLI.

Changing the endpoint creates a deterministic config-only release. It does not run the generation agent or modify the command surface.

Usage
okibi clis endpoint [command]

Commands

setPublish a config-only release with a new API endpoint
statusShow the API endpoint in the official generated source

Inherited flags

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

okibi clis endpoint set

Publish a config-only release with a new API endpoint

Usage
okibi clis endpoint set <cli> <url> [flags]

Flags

FlagTypeDescription
--allow-missing-identityboolpublish even when the endpoint has no compatible Identity manifest

Inherited flags

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

okibi clis endpoint status

Show the API endpoint in the official generated source

Usage
okibi clis endpoint status <cli> [flags]

Inherited flags

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

okibi clis feedback

Read the CLI feedback inbox

Usage
okibi clis feedback <cli> [flags]

Flags

FlagTypeDescription
--limitintmaximum feedback entries (1-200)default 100

Inherited flags

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

okibi clis hosting

Configure source hosting and install visibility without opening the TUI.

Use status to inspect the current destination, target to switch between Okibi-hosted and your own GitHub repository, visibility to choose the audience, and publish to push the current generated source.

Usage
okibi clis hosting [command]

Commands

publishPublish the current generated source to its hosting target
statusShow hosting, visibility, release, and install state
targetChoose Okibi hosting or a private GitHub repository
visibilityChoose who can use the official install link

Inherited flags

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

okibi clis hosting publish

Publish the current generated source to its hosting target

Usage
okibi clis hosting publish <cli> [flags]

Inherited flags

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

okibi clis hosting status

Show hosting, visibility, release, and install state

Usage
okibi clis hosting status <cli> [flags]

Inherited flags

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

okibi clis hosting target

Choose Okibi hosting or a private GitHub repository

Usage
okibi clis hosting target <cli> <hosted|github> [flags]

Flags

FlagTypeDescription
--accountstringGitHub user or organization login
--repostringGitHub repository name (defaults to the CLI name)

Inherited flags

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

okibi clis hosting visibility

Choose who can use the official install link

Usage
okibi clis hosting visibility <cli> <workspace|public> [flags]

Inherited flags

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

okibi clis identity

Enable or disable Okibi Identity for a CLI

Usage
okibi clis identity [command]

Commands

disableDisable Okibi Identity immediately
enableEnable Okibi Identity immediately
statusShow whether Identity is offered

Inherited flags

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

okibi clis identity disable

Disable Okibi Identity immediately

Usage
okibi clis identity disable <cli> [flags]

Inherited flags

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

okibi clis identity enable

Enable Okibi Identity immediately

Usage
okibi clis identity enable <cli> [flags]

Inherited flags

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

okibi clis identity status

Show whether Identity is offered

Usage
okibi clis identity status <cli> [flags]

Inherited flags

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

okibi clis insights

Show Identity usage, anonymous command reports, and installer metrics

Usage
okibi clis insights <cli> [flags]
okibi clis insights [command]

Commands

eventsRead one JSON page of anonymous command events, optionally within a group
groupsRead one JSON page of anonymous command groups

Inherited flags

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

okibi clis insights events

Read one JSON page of anonymous command events, optionally within a group

Usage
okibi clis insights events <cli> [group] [flags]

Flags

FlagTypeDescription
--cursorstringopaque cursor returned by the previous page
--limitintentries per page (1–50)default 50

Inherited flags

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

okibi clis insights groups

Read one JSON page of anonymous command groups

Usage
okibi clis insights groups <cli> [flags]

Flags

FlagTypeDescription
--cursorstringopaque cursor returned by the previous page
--limitintentries per page (1–20)default 20

Inherited flags

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

okibi clis install

Prepare an exact historical run without changing the official release, then print a short-lived, workspace-scoped install command. Swept artifacts are rebuilt automatically. Use --no-wait to return as soon as rebuilding starts.

Usage
okibi clis install <cli> [flags]

Flags

FlagTypeDescription
--no-waitboolstart artifact preparation and return immediately
--runstringrun ID or run number (for example 42)
--timeoutdurationmaximum time to wait for a rebuilt artifactdefault 5m0s

Inherited flags

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

okibi clis mcp

Configure hosted MCP clients and manage your connections

Usage
okibi clis mcp [command]

Commands

connectionsList your hosted MCP client connections
disconnectRevoke your MCP connection and delete its saved credentials
setupShow hosted MCP URLs and client configurations

Inherited flags

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

okibi clis mcp connections

List your hosted MCP client connections

Usage
okibi clis mcp connections <cli> [flags]

Inherited flags

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

okibi clis mcp disconnect

Revoke your MCP connection and delete its saved credentials

Usage
okibi clis mcp disconnect <cli> <connection-id> [flags]

Flags

FlagTypeDescription
--yesboolconfirm revocation and deletion of this connection’s credentials

Inherited flags

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

okibi clis mcp setup

Show hosted MCP URLs and client configurations

Usage
okibi clis mcp setup <cli> [flags]

Flags

FlagTypeDescription
--runstringpin setup URLs to a successful run ID or number

Inherited flags

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

okibi clis npm

Okibi publishes each official release to npm from a workflow in your CLI's repository, which npm accepts through trusted publishing. npm can only trust a workflow for a package that already exists, so the first publish runs here, with your own npm login.

Usage
okibi clis npm [command]

Commands

setupPublish the first version to npm and trust Okibi's release workflow

Inherited flags

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

okibi clis npm setup

Publishes the current official release of <cli> to npm with your npm login (run npm login first), then tells npm to trust the release workflow in the CLI's repository for every package. Okibi never sees your npm credentials. npm may ask for your second factor. Needs npm 11.15 or later.

Usage
okibi clis npm setup <cli> [flags]

Flags

FlagTypeDescription
--skip-publishboolonly set up trusted publishing (every package already exists)
--skip-trustboolonly publish the first version

Inherited flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai
--jsonboolemit JSON
--workspacestringworkspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace)
Examples
npm login
okibi clis npm setup my-cli

okibi clis project-name

Set a CLI's project/display name without renaming its binary

Usage
okibi clis project-name <cli> <project-name> [flags]

Inherited flags

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

okibi clis publish

Build commits on the CLI repository's default branch as a new version. Official and private testing releases remain selected separately with clis release set or clis testing set.

Usage
okibi clis publish <cli> [flags]

Flags

FlagTypeDescription
--commitstringrequire the exact repository HEAD shown by clis changes

Inherited flags

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

okibi clis release

Select or clear the official release

Usage
okibi clis release [command]

Commands

clearTake down the official release
setMake one historical release official

Inherited flags

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

okibi clis release clear

Take down the official release

Usage
okibi clis release clear <cli> [flags]

Inherited flags

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

okibi clis release set

Make one historical release official

Usage
okibi clis release set <cli> [flags]

Flags

FlagTypeDescription
--releasevaluerelease ID from okibi clis releases
--runstringsuccessful run ID

Inherited flags

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

okibi clis releases

List the immutable release history

Usage
okibi clis releases <cli> [flags]

Flags

FlagTypeDescription
--limitintmaximum releases to return (1-500)default 100

Inherited flags

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

okibi clis rename

Rename a CLI everywhere, including its hosted repository

Usage
okibi clis rename <cli> <new-name> [flags]

Inherited flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai
--jsonboolemit JSON
--workspacestringworkspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace)
Examples
okibi clis rename stripe-old stripe --agent

okibi clis show

Show the important state of one CLI

Usage
okibi clis show <cli> [flags]

Inherited flags

FlagTypeDescription
--api-urlstringOkibi API base URLdefault https://okibi.ai
--jsonboolemit JSON
--workspacestringworkspace slug (or OKIBI_WORKSPACE; default: this machine's default workspace)
Examples
okibi clis show stripe --agent

okibi clis skill

Read, edit, and release the canonical SKILL.md

Usage
okibi clis skill [command]

Commands

publishRelease the saved SKILL.md as a new official version
setEdit SKILL.md with optimistic concurrency
showPrint the canonical SKILL.md

Inherited flags

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

okibi clis skill publish

Builds a new version of the CLI from its published code with the SKILL.md saved by `okibi clis skill set`, then moves the official release to that version. The CLI needs an official release first.

Usage
okibi clis skill publish <cli> [flags]

Inherited flags

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

okibi clis skill set

Use --file <path>, --file - for stdin, or omit --file to open $VISUAL/$EDITOR.

Usage
okibi clis skill set <cli> [flags]

Also available as edit

Flags

FlagTypeDescription
-f, --file-read SKILL.md from a file (- for stdin); default opens an editor

Inherited flags

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

okibi clis skill show

Print the canonical SKILL.md

Usage
okibi clis skill show <cli> [flags]

Inherited flags

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

okibi clis testing

Select existing versions and manage private tester access

Usage
okibi clis testing [flags]
okibi clis testing [command]

Commands

clearClear the private testing release
inviteInvite an external tester
reactivateReactivate tester access
revokeRevoke tester access
setPin a release for private testing
statusShow the private testing release and candidates
suspendSuspend tester access
testersList external testers and access state

Inherited flags

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

okibi clis testing clear

Clear the private testing release

Usage
okibi clis testing clear <cli> [flags]

Inherited flags

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

okibi clis testing invite

Invite an external tester

Usage
okibi clis testing invite <cli> <email> [flags]

Flags

FlagTypeDescription
--namestringtester display name
--notesstringnotes shown to the tester

Inherited flags

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

okibi clis testing reactivate

Reactivate tester access

Usage
okibi clis testing reactivate <cli> <assignment-id> [flags]

Inherited flags

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

okibi clis testing revoke

Revoke tester access

Usage
okibi clis testing revoke <cli> <assignment-id> [flags]

Inherited flags

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

okibi clis testing set

Pin a release for private testing

Usage
okibi clis testing set <cli> [flags]

Flags

FlagTypeDescription
--notesstringrelease notes shown to testers
--releasestringrelease ID
--runstringsuccessful run ID

Inherited flags

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

okibi clis testing status

Show the private testing release and candidates

Usage
okibi clis testing status <cli> [flags]

Inherited flags

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

okibi clis testing suspend

Suspend tester access

Usage
okibi clis testing suspend <cli> <assignment-id> [flags]

Inherited flags

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

okibi clis testing testers

List external testers and access state

Usage
okibi clis testing testers <cli> [flags]

Inherited flags

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