CLI Reference

ig [OPTIONS] <PATTERN> [PATH]
ig search [OPTIONS] <PATTERN> [PATH]  # also works

$ ig --top 5 useState
apps/.../create-conversational/vehicle-edit-step-dialog.tsx
  3: import { useState, useMemo } from "react";
 73:   const [value, setValue] = useState(formData.saleMode);
107:   const [brandId, setBrandId] = useState(formData.brand);
 …
(top-5 returns 3 KB instead of the 15 KB flat compressed output)

$ ig --semantic --top 5 throw
(semantic: expanded 'throw' → got, inattendu, denied, autorisé, trouvée, manquant)
apps/packages/reader-api-vo/scripts/test-rest-e2e.ts
 44:   throw new Error("HTTP server did not become ready in time");
114:     throw new Error(`${label} should be an array`);
 …
# finds literal throws AND French exception messages, in one pass

# Basic regex search
ig "async fn \w+" src/

# Case-insensitive with 2 lines of context
ig -i -C 2 "TODO" .

# JSON output for AI agents
ig --json "impl \w+ for" src/

# Only Rust files
ig --type rs "pub fn" .

# Files matching glob
ig --glob 'src/**/*.rs' "Result<" .

# Show stats (candidates filtered, time)
ig --stats "use std" .

ig index [OPTIONS]   # default: current directory

# Index current directory
ig index

# Index specific path
ig index /path/to/project

# Force rebuild (even if index exists)
ig index --force .

ig status .

instant-grep index status
──────────────────────────
Location:    /home/user/project/.ig/
Version:     7
Files:       1,552
N-grams:     48,392
Lexicon:     31 MB
Postings:    7.1 MB
Metadata:    111 KB
Built:       2026-03-24 10:12:08

# Watch and auto-rebuild on changes
ig watch .

[watching] src/ — press Ctrl+C to stop
[rebuild]  src/main.rs modified → rebuilding... done (43ms)
[rebuild]  src/lib.rs created → rebuilding... done (51ms)

ig daemon start     [PATH]   # start daemon in background
ig daemon stop      [PATH]   # stop running daemon
ig daemon status    [PATH]   # check if daemon is running
ig daemon install   [PATH]   # install launchd service (macOS auto-restart)
ig daemon uninstall [PATH]   # remove launchd service

# Start daemon
ig daemon start .

[daemon] Daemon started
[daemon] Socket: .ig/daemon.sock
[daemon] Index loaded: 1,552 files (36 MB)
[daemon] Ready for queries...

# Check status
ig daemon status .
[daemon] Running (PID 12345) · socket: .ig/daemon.sock

# Install as launchd service for auto-restart (macOS)
ig daemon install .

ig query [OPTIONS] <PATTERN> [PATH]

# Query daemon (sub-ms)
ig query "async fn" .

# JSON output via daemon
ig query --json "Result<" .

# p50 latency: 0.3ms (warm daemon)

ig files [OPTIONS] [PATH]

# List all project files
ig files

# Only Rust files
ig files -t rust

# JSON output for agents
ig files --json

# With glob filter
ig files -g "src/**/*.ts"

# Tree-compressed view — directories with file counts
ig files --compact

# Compact view filtered to PHP files
ig files --compact -t php

$ ig files | head
3201 files in 911 dirs · 972 tsx, 890 php, 790 ts, 80 mdx, 70 py, 47 json
(compact view — set IG_COMPACT=0 or run in a TTY for the full listing)

# iautos monorepo: 176 KB → 149 B (≈1180×)

ig symbols [OPTIONS] [PATH]

# All symbols in project
ig symbols

# Only Rust symbols
ig symbols -t rust

# JSON output (for agents)
ig symbols --json

# Symbols in specific directory
ig symbols src/

ig context <FILE> <LINE>

# Show function containing line 42
ig context src/main.rs 42

# JSON output
ig context --json src/main.rs 42

ig ls [PATH]   # default: current directory

# Compact listing of current project
ig ls

src/          (12 files)
  index/      (6 files)  ngram.rs  reader.rs  writer.rs  ...
  query/      (2 files)  extract.rs  mod.rs
  main.rs  daemon.rs  read.rs  smart.rs

# Listing a subdirectory
ig ls src/

ig read <FILE> [OPTIONS]

# Full file content
ig read src/daemon.rs

# Signatures only (functions + structs — much smaller)
ig read -s src/daemon.rs

pub fn start_daemon(path: &Path) -> Result<()>
pub fn stop_daemon(path: &Path) -> Result<()>
pub async fn handle_connection(stream: UnixStream)

# Aggressive compression — strip comments, collapse blanks, elide bodies
ig read -a src/daemon.rs

# Budget mode — keep the 500 most informative tokens
ig read -b 500 src/daemon.rs

# Budget + relevance boost — prioritize payment-related code
ig read -b 500 -r "payment" src/billing.php

# Delta mode — only git-changed lines with enclosing signatures
ig read -d src/main.rs

ig smart [PATH]   # default: current directory

# 2-line summaries for all project files
ig smart

src/daemon.rs
  Unix socket server — start/stop/status/install lifecycle.
  Keeps index mmap'd for sub-ms query latency.

src/index/ngram.rs
  Sparse n-gram generation via hash_bigram + covering set selection.
  Core algorithm — port of danlark1/sparse_ngrams.

$ ig smart apps/api
apps/api: 1042 files, 249 dirs · 890 php, 39 yaml, 31 twig, 29 sh, 10 md
top: src/ (664), migrations/ (109), tests/ (103), config/ (42)
key: composer.json, README.md, Makefile

# 345 B / 19 ms — down from 69 KB / 5.3 s (≈200× smaller, ≈280× faster)
# Force full per-file summary: IG_COMPACT=0 ig smart apps/api

ig pack [PATH]   # writes .ig/context.md

# .ig/context.md contains:

## Directory Tree    — compact ig ls output
## Symbols          — all function/class/struct definitions
## Dependencies     — Cargo.toml or package.json (v1.3+)
## API Routes       — Next.js app/api/** routes (v1.3+)
## Environment      — .env.example keys (v1.3+)

ig gain [OPTIONS]    # show savings dashboard
ig gain --clear      # reset history

ig gain

instant-grep token savings
────────────────────────────────
Session:      47 rewrites
Tokens saved: 142,380
Cost saved:   $0.13
Top command:  git status  (38 rewrites, 91K tokens)

# Main dashboard
ig gain

# Daily savings chart (last 14 days)
ig gain --graph

# Monthly token projection
ig gain --quota

# Current project only
ig gain -p

# Find missed optimization opportunities
ig gain --discover

# Per-command history with individual savings (new in v1.4)
ig gain --history

# Machine-readable JSON output (new in v1.4)
ig gain --json

command history (last 10)
────────────────────────────────────────────
2026-03-27 14:32  git status    -605B   (-83%)
2026-03-27 14:35  git log -10   -7,864B (-89%)
2026-03-27 14:41  grep -r …     -2,100B (-94%)
2026-03-27 14:50  git diff      -19,382B (-74%)

ig setup

ig setup

✓ Claude Code
  → Added Bash(ig *) permission to settings.json
  → Added Search Tools section to CLAUDE.md
✓ Codex CLI
  → Added Search Tools section to AGENTS.md
ℹ Gemini CLI (manual config needed)

ig git <SUBCOMMAND> [GIT OPTIONS]   # proxies to rtk git <subcommand>

# Compressed git status (127B instead of 732B)
ig git status

# Compact log — 10 entries, -89% token reduction
ig git log -10

# Diff with noise stripped
ig git diff

# Show last commit
ig git show HEAD

# Branch list
ig git branch

ig discover [OPTIONS]   # scan Claude Code session logs

# Scan all sessions for missed savings
ig discover

# Limit to sessions since March 2026
ig discover --since 2026-03-01

# Show top 20 missed opportunities
ig discover --limit 20

ig proxy <COMMAND> [ARGS...]   # execute raw without filtering

# Run git status without compression (debug)
ig proxy git status

# Run grep without rewriting
ig proxy grep -r "pattern" src/

# Compare native vs compressed
ig proxy git log -5
ig git log -5

grep -r "pattern" src/   →  ig "pattern" src/
find . -name "*.rs"      →  ig files -t rs .
git status               →  ig git status

{
  "pattern": "async fn",
  "matches": [
    {
      "file": "src/daemon.rs",
      "line": 23,
      "text": "pub async fn handle_connection(stream: UnixStream) {"
    }
  ],
  "stats": {
    "duration_ms": 0.9,
    "candidates": 47,
    "matches": 3
  }
}