CLI

The irag CLI provides terminal access to IntelliRag’s code intelligence. Use it in scripts, CI pipelines, or as a quick alternative to the MCP tools.

Installation

Go install

go install github.com/intellirag/intellirag.io/cli/cmd/irag@latest

Binary release

Download the latest binary for your platform from the GitHub releases page. After downloading:

chmod +x irag
sudo mv irag /usr/local/bin/

Homebrew

brew install intellirag/tap/irag

Verify the installation:

irag version

Authentication

Browser login (recommended)

Log in with your browser - supports SSO through your organization’s identity provider:

irag auth login

This opens your browser to the IntelliRag login page. After authenticating, the browser redirects back and your credentials are stored locally at ~/.config/irag/credentials.json. Subsequent commands use these credentials automatically, refreshing the access token as needed.

Check your login status:

irag auth status

Log out and remove stored credentials:

irag auth logout

API key (CI/headless environments)

For CI pipelines, Docker containers, and other non-interactive environments, use an API key instead. The CLI resolves credentials in this order:

1. --api-key flag (highest priority)
2. RAG_API_KEY environment variable
3. OAuth2 tokens from ~/.config/irag/credentials.json (from irag auth login)
4. Config file at ~/.config/irag/config.yaml

Config file

Create ~/.config/irag/config.yaml:

api_url: https://api.intellirag.io
api_key: rag_xxxxxxxxxxxx

Global flags

Flag	Short	Description
--api-url		API server URL
--api-key		API key (overrides env and config file)
--output	-o	Output format: table, json, yaml (default: table)

Quick examples

Search for code semantically:

irag search "authentication middleware" --repo-id abc123

Look up a symbol by its fully qualified name:

irag symbols fqn "com.example.UserService.findById" --repo-id abc123

Trace who calls a method:

irag graph callers "com.example.UserService.findById" --depth 3

Analyze the impact of changing a class:

irag impact "com.example.User" --repo-id abc123

Get JSON output for scripting:

irag debt --repo-id abc123 -o json | jq '.items[] | .file'

Next steps

• CLI Commands - complete reference for all commands
• API Reference - the REST API the CLI wraps