Kirha Docs - Kirha CLI

Command Line Interface (CLI)

This tool allows you to interact with Kirha directly from a terminal. For example, you can log in to your account, run searches and tasks, and configure agents to use Kirha MCP, skills, etc. In this guide, we will look at the main features of the CLI and how to use them.

kirha-ai/kirha-cli

Installation

curl -fsSL https://cli.kirha.com/install.sh | sh

Downloads a precompiled binary for macOS (arm64/x64) or Linux (x64/arm64) and installs to ~/.kirha/bin/kirha. Your shell PATH is updated automatically.

npm install -g @kirha/cli

Or run once without installing:

npx @kirha/cli search "..."

Authentication

Get an API key

Log in

kirha auth login --api-key <YOUR_API_KEY>

Or interactively:

kirha auth login

Credentials are stored in ~/.config/kirha/auth.json (user-readable only).

Verify

kirha auth status

{ "authenticated": true, "source": "file" }

API key resolution order

--api-key flag (per command) → 2. Config file (~/.config/kirha/auth.json) → 3. KIRHA_API_KEY environment variable.

Commands

Search

Query real-time data across any vertical.

kirha search "What's the largest USDC holder on Base?" --vertical crypto

With summarization:

kirha search "Latest patents in quantum computing" --summarize
kirha search "Latest SEC filings for Nvidia" --summarize --instruction "Format as table"

Prop

Type

Input can come from argument, stdin, or pipe:

echo "What's hot in DeFi today?" | kirha search

Plan

Preview execution steps and estimated cost before running a query.

# Create a plan
kirha plan create "Compare ETH vs Base trading volume"

# Execute it
kirha plan exec plan_abc123

Task

Run long-running deep research (can take several minutes).

# Create and wait for result
kirha task run "Compare AI strategies of Google, Microsoft, Meta"

# Fire and forget
kirha task create "Compare AI strategies..."
kirha task status tsk_abc123
kirha task result tsk_abc123

Prop

Type

Tools

Call individual Kirha tools directly.

# List available tools
kirha tools list --vertical crypto

# Run a tool
kirha tools run zerion_getEthereumWalletProfitAndLoss \
  --input '{"currency":"usd","ethereumAddress":"0x..."}'

Discovery

Browse available verticals and providers.

kirha discovery verticals list
kirha discovery verticals get crypto

kirha discovery providers list
kirha discovery providers get zerion

MCP

Install the Kirha MCP and configure AI clients.

# Interactive picker
kirha mcp install

# Target specific clients
kirha mcp install --client claudecode
kirha mcp install --client claudecode,codex
kirha mcp install --client all

Supported clients: Claude Code, Codex, OpenCode, Gemini CLI, Droid.

kirha mcp update --client claudecode    # re-sync API key
kirha mcp remove --client claudecode    # uninstall
kirha mcp show   --client claudecode    # show config

Skills

Install the Kirha Skill and configure AI agents.

kirha skills install --yes
kirha skills install --agent claude-code --yes

Supports 45+ agents including Claude Code, Cursor, Cline, Codex, and more.

Config

Set defaults so you don't have to repeat flags.

kirha config set vertical crypto
kirha config set runtime standard
kirha config get vertical
kirha config list
kirha config unset vertical

Priority: flag → config file → environment variable.

Upgrade

kirha upgrade          # install latest version
kirha upgrade --check  # check without installing

Output format

All commands output JSON, one object per invocation. Pipe to jq for processing:

kirha search "Top 5 stablecoin yields" | jq '.summary'

Errors go to stderr as stable JSON:

{ "error": { "code": "AUTH_REQUIRED", "message": "..." } }

Exit codes: 0 success, 2 bad usage, 3 auth required, 4 rate limit, 5 network error, 6 expired plan.

Uninstall

rm -rf ~/.kirha ~/.config/kirha

npm uninstall -g @kirha/cli
rm -rf ~/.config/kirha

Kirha CLI

On this page