Utilities

This page covers the smaller, less-frequently-used commands: doctor, switch, update, completions, and schema.

islo doctor

Check the local CLI setup — authentication, configuration, and connectivity to the Islo API.

$
islo doctor

Run islo doctor first when something looks wrong. It surfaces:

• Whether you are logged in (and which method — OAuth or ISLO_API_KEY)
• Whether islo.yaml (if present) parses cleanly
• Whether the API is reachable from your machine

No flags. Add --output json for structured output.

islo switch

Switch between organizations (tenants) you belong to.

$
islo switch

Behavior:

1. Prints your current organization.
2. Opens your browser for an OAuth flow that lets you pick a different org.
3. Replaces your stored credentials with the new org’s tokens.

There is no inline org picker — selection happens in the browser via Descope. After the flow, run islo status to confirm.

islo update

Update the CLI to the latest version, or install a specific one.

$
islo update [options]

Aliases: islo upgrade

Examples:

$
islo update                          # Update to latest stable
$
islo update --check                  # Only check for updates
$
islo update --version v0.21.0        # Pin to a version
$
islo update --channel dev            # Track the dev channel
$
islo update --channel dev --force    # No prompt

The command prints the current and latest versions, then downloads and runs install.sh from the releases server — the same path a fresh install uses. If you originally installed via cargo install, islo update skips the auto-update path; use cargo install to update instead.

islo completions

Install or print shell completion scripts.

$
islo completions <subcommand>

Install

$
islo completions install [--shell <shell>]

Adds an eval "$(islo completions show <shell>)" line to your shell’s rc file (e.g., ~/.zshrc, ~/.bashrc). If --shell is omitted, the current shell is detected from $SHELL. Supported shells: bash, zsh, fish.

$
islo completions install              # Auto-detect shell
$
islo completions install --shell zsh  # Force zsh

Open a new terminal (or source your rc file) for completions to take effect.

Show

$
islo completions show <shell>

Prints the source line for the requested shell to stdout. Use this when you want to wire completions in by hand instead of letting install edit your rc file.

$
islo completions show bash
$
islo completions show zsh

islo schema

Output the machine-readable command schema as JSON. Intended for scripts and AI agents that drive the CLI.

$
islo schema [command] [--short]

Examples:

$
islo schema                  # Top-level overview (skills + commands)
$
islo schema use              # Full args, flags, and examples for `islo use`
$
islo schema gateway          # Schema for the gateway command tree
$
islo schema --short          # Minified overview

Use this when you want a programmatic source of truth for the CLI surface — it always matches the installed binary, while these docs may lag a release behind.