KIRHA Docs - KIRHA CLI

Command Line Interface (CLI)

The CLI runs KIRHA from your terminal: log in, search, preview plans, call tools, and set up the KIRHA MCP server and skill in your coding agents. Every command prints JSON, so scripts and agents can parse the output.

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

KIRHA picks the providers itself, across every vertical.

kirha search "What does the boxed warning on Ozempic say?"

With a summary:

kirha search "Summarize latest NVIDIA earning calls" --summarize
kirha search "List top 10 stablecoins yield on Ethereum" --summarize --instruction "Format as a table"

To restrict the search to one vertical, pass --focus:

kirha search "List top 10 stablecoins yield on Ethereum" --focus crypto

Prop

Type

Input can come from argument, stdin, or pipe:

echo "How to stream AI responses in Next.js using the latest AI SDK?" | kirha search

Plan

Preview execution steps and estimated cost before running a query.

# Create a plan
kirha plan create "Find engineers working at companies behind the latest patents in Machine Learning"
# → { "id": "search_...", "steps": [...], "usage": {...} }

# Run it
kirha plan exec search_abc123

plan create takes --runtime too. A plan expires 5 minutes after it is created.

Tools

Call a single KIRHA tool directly. Listing tools needs a focus.

# List available tools
kirha tools list --focus 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 server in your 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 in your 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 focus crypto
kirha config set runtime standard
kirha config get focus
kirha config list
kirha config unset focus

Priority: flag → config file → environment variable (KIRHA_FOCUS, KIRHA_RUNTIME).

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 "Summarize latest NVIDIA earning calls" --summarize | 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