CLI Reference
Getting Help
Section titled “Getting Help”To see all available CLI commands and options, run:
uv run komodo --helpFor help with a specific command:
uv run komodo <command> --helpGlobal Options
Section titled “Global Options”| Flag | Description |
|---|---|
--version, -v | Show the CLI version and exit |
--help | Show help text and exit |
Authentication
Section titled “Authentication”komodo login
Section titled “komodo login”Start the OAuth 2.0 Device Authorization Flow. Opens your browser for
authentication and stores your JWT and refresh token in ~/.komodo/credentials.
uv run komodo login| Flag | Description |
|---|---|
-E, --environment | Target environment: production (default) or integration |
komodo jwt
Section titled “komodo jwt”Print the current JWT token for debugging or use with external tools.
uv run komodo jwt| Flag | Description |
|---|---|
-E, --environment | Target environment |
Account Management
Section titled “Account Management”komodo account set
Section titled “komodo account set”Interactively select the active Komodo account from your available accounts.
uv run komodo account setkomodo account get
Section titled “komodo account get”Print the currently selected account ID and slug.
uv run komodo account getkomodo account list
Section titled “komodo account list”List all accounts you have access to.
uv run komodo account listService Principals
Section titled “Service Principals”Manage service principal credentials for machine-to-machine (M2M) authentication. See the Authentication guide for usage.
komodo service-principal create
Section titled “komodo service-principal create”Create a new service principal. Returns the client_id and client_secret.
uv run komodo service-principal create --name "my-service" --description "My service principal"| Flag | Description |
|---|---|
--name | Name for the service principal (required) |
--description | Description (optional) |
komodo service-principal list
Section titled “komodo service-principal list”List all service principals for the current account.
uv run komodo service-principal listkomodo service-principal delete
Section titled “komodo service-principal delete”Delete a service principal by ID.
uv run komodo service-principal delete <SERVICE_PRINCIPAL_ID>MCP Server
Section titled “MCP Server”komodo mcp show-config
Section titled “komodo mcp show-config”Generate the MCP server configuration JSON for your AI client. The output is automatically copied to your clipboard.
uv run komodo mcp show-config| Flag | Description |
|---|---|
--name, -n | Custom server name (default: komodo) |
See the MCP Server guide for full setup instructions.
komodo mcp run
Section titled “komodo mcp run”Start the MCP server with STDIO transport. Typically started automatically by
your AI client via the configuration from show-config.
uv run komodo mcp runSQL Queries
Section titled “SQL Queries”komodo sql-execute
Section titled “komodo sql-execute”Execute a single SQL statement against your Snowflake warehouse and display the results in a formatted table.
uv run komodo sql-execute "SELECT column_name FROM INFORMATION_SCHEMA.COLUMNS LIMIT 10"| Flag | Description |
|---|---|
-E, --environment | Target environment |
komodo sql-shell
Section titled “komodo sql-shell”Start an interactive SQL shell for running multiple queries in a session.
Type exit to quit. Errors in one statement do not exit the shell.
uv run komodo sql-shell| Flag | Description |
|---|---|
-E, --environment | Target environment |
Plugin Management
Section titled “Plugin Management”komodo plugin install
Section titled “komodo plugin install”Install a Komodo CLI plugin package. Without arguments, installs
komodo-internal-tools from Komodo’s internal package registry.
uv run komodo plugin install| Flag | Description |
|---|---|
--package | Specific package name to install |
--path | Install from a local path |
komodo plugin uninstall
Section titled “komodo plugin uninstall”Uninstall a plugin package.
uv run komodo plugin uninstall <PACKAGE_NAME>komodo plugin list
Section titled “komodo plugin list”List installed plugins and their registered CLI commands and MCP tools.
uv run komodo plugin listUtility Commands
Section titled “Utility Commands”komodo docs
Section titled “komodo docs”Open the Komodo SDK documentation in your browser.
uv run komodo docskomodo feedback
Section titled “komodo feedback”Submit feedback about the Komodo SDK.
uv run komodo feedbackBeta Commands
Section titled “Beta Commands”Beta commands are accessed through the komodo beta subgroup:
uv run komodo beta --helpkomodo beta cohort-exploration
Section titled “komodo beta cohort-exploration”Explore patient cohorts interactively using the Cohort API. This command provides a streamlined interface for rapid validation of clinical hypotheses via interactive prompts.
uv run komodo beta cohort-explorationFeatures:
- Simple mode — Guided prompts for diagnosis codes (ICD-10), procedure codes (CPT/HCPCS), and drug references (NDC)
- Advanced mode — Build complex AND/OR/nested condition logic
- Quick count — Fast approximate or exact distinct patient count
- Comprehensive summary — Demographic breakdowns by time trends, gender, age, state, race/ethnicity, and mortality
Supported parameters:
- Diagnosis Code (ICD-10 format, e.g.,
C34%,C50.1) - Procedure Code (CPT/HCPCS format, e.g.,
96413,J9271) - Drug Reference (NDC Code, e.g.,
12345-6789-01) - Time Duration (date range in
mm/dd/yyformat)
Options:
| Flag | Description |
|---|---|
-E, --environment | Target environment (default: production) |