CLI Commands
All commands accept the global flags (--api-url, --api-key, --output). Examples below assume authentication is configured via config file or environment variable.
search
Section titled “search”Semantic code search across your indexed repository.
irag search "authentication middleware" --repo-id <id>| Flag | Description |
|---|---|
--query |
Search query (also accepted as a positional argument) |
--repo-id |
Repository ID (required) |
--workspace-id |
Workspace ID (narrows scope) |
--language |
Filter by language (e.g. java, go, python) |
--limit |
Maximum number of results (default: 10) |
Example:
irag search "database connection pooling" --repo-id abc123 --language go --limit 5symbols
Section titled “symbols”Look up symbols (functions, classes, methods, interfaces) by name or fully qualified name.
symbols fqn
Section titled “symbols fqn”Look up a symbol by its fully qualified name.
irag symbols fqn "com.example.UserService.findById" --repo-id <id>Returns the symbol’s signature, file location, documentation, and metadata.
symbols search
Section titled “symbols search”Search symbols by name pattern.
irag symbols search "UserService" --repo-id <id>| Flag | Description |
|---|---|
--kind |
Filter by symbol kind: function, class, method, interface |
--language |
Filter by language |
Example:
irag symbols search "Handler" --repo-id abc123 --kind method --language gosymbols refs
Section titled “symbols refs”Find all references to a symbol.
irag symbols refs "com.example.UserService" --repo-id <id>Returns a list of files and locations where the symbol is referenced.
Query the code graph for call relationships, dependencies, paths, and data flow.
graph callers
Section titled “graph callers”Show all callers of a symbol, optionally traversing multiple levels.
irag graph callers "com.example.UserService.findById" --depth 3| Flag | Description |
|---|---|
--depth |
How many levels of callers to traverse (default: 1) |
graph callees
Section titled “graph callees”Show all symbols called by a given symbol.
irag graph callees "com.example.UserService.findById" --depth 2| Flag | Description |
|---|---|
--depth |
How many levels of callees to traverse (default: 1) |
graph path
Section titled “graph path”Find the call path between two symbols.
irag graph path --from "Controller.handle" --to "Repository.save"| Flag | Description |
|---|---|
--from |
Starting symbol FQN (required) |
--to |
Target symbol FQN (required) |
graph deps
Section titled “graph deps”Show module-level dependency relationships.
irag graph deps "pkg/auth" --direction downstream| Flag | Description |
|---|---|
--direction |
upstream (what this module depends on) or downstream (what depends on this module) |
graph cycles
Section titled “graph cycles”Detect dependency cycles in the repository.
irag graph cycles --repo-id <id>graph dataflow
Section titled “graph dataflow”Trace data flow through a symbol, showing how data propagates via parameters and return values.
irag graph dataflow "com.example.UserService.findById"impact
Section titled “impact”Analyze the impact of changing a symbol or file. Shows affected callers, dependent modules, and downstream entry points.
irag impact "com.example.User" --repo-id <id>Use this before making changes to understand the blast radius.
List technical debt items (TODO, FIXME, HACK markers) with file locations and context.
irag debt --repo-id <id>| Flag | Description |
|---|---|
--severity |
Filter by severity: low, medium, high, critical |
Example:
irag debt --repo-id abc123 --severity high -o jsonconfig
Section titled “config”Inspect application configuration keys detected in the codebase.
config list
Section titled “config list”List all configuration keys found in the repository.
irag config list --repo-id <id>config get
Section titled “config get”Get details for a specific configuration key, including where it is defined and consumed.
irag config get "spring.datasource.url" --repo-id <id>config undocumented
Section titled “config undocumented”Find configuration keys that lack documentation or descriptions.
irag config undocumented --repo-id <id>schema
Section titled “schema”Browse database schemas detected from DDL, migrations, and ORM definitions.
schema list
Section titled “schema list”List all database schemas in the repository.
irag schema list --repo-id <id>schema tables
Section titled “schema tables”List tables in the database schema.
irag schema tables --repo-id <id>schema detail
Section titled “schema detail”Show detailed information about a table, including columns, types, constraints, and relationships.
irag schema detail "users" --repo-id <id>schema search
Section titled “schema search”Search schemas by name pattern.
irag schema search "user" --repo-id <id>events
Section titled “events”Explore event-driven architecture: producers, consumers, and event flow.
events producers
Section titled “events producers”List all event producers in the repository.
irag events producers --repo-id <id>events consumers
Section titled “events consumers”List all event consumers in the repository.
irag events consumers --repo-id <id>events flow
Section titled “events flow”Trace the flow of a specific event from producer through consumers.
irag events flow "OrderCreated" --repo-id <id>contracts
Section titled “contracts”Inspect API contracts detected from OpenAPI/Swagger specifications.
contracts list
Section titled “contracts list”List all API contracts in the repository.
irag contracts list --repo-id <id>contracts get
Section titled “contracts get”Get details for a specific API endpoint contract.
irag contracts get "/api/users" --repo-id <id>contracts diff
Section titled “contracts diff”Compare API contracts between two branches to detect breaking changes.
irag contracts diff --base main --head feature/auth --repo-id <id>| Flag | Description |
|---|---|
--base |
Base branch for comparison (required) |
--head |
Head branch for comparison (required) |
Manage indexing operations for a repository.
index status
Section titled “index status”Show the current indexing status, including last run time, indexed file count, and any errors.
irag index status --repo-id <id>index full
Section titled “index full”Trigger a full reindex of the repository. This re-analyzes all files regardless of changes.
irag index full --repo-id <id>index incremental
Section titled “index incremental”Trigger an incremental index that only processes files changed since the last run.
irag index incremental --repo-id <id>index lock
Section titled “index lock”Lock indexing for a repository. Prevents any index operations from running, useful during migrations or maintenance.
irag index lock --repo-id <id>index unlock
Section titled “index unlock”Unlock indexing for a previously locked repository.
irag index unlock --repo-id <id>Manage authentication. Supports browser-based login with SSO.
auth login
Section titled “auth login”Open a browser to authenticate with IntelliRag. Supports SSO through your organization’s identity provider. Tokens are stored at ~/.config/irag/credentials.json.
irag auth login| Flag | Description |
|---|---|
--auth-url |
OAuth2 authorization server URL (default: auto-detected) |
auth logout
Section titled “auth logout”Remove locally stored credentials.
irag auth logoutauth status
Section titled “auth status”Show current authentication status, including account email and token expiry.
irag auth status