cli.directory

rg

Agent-readyGit & GitHubShell Utilities

Code search, fast grep, and agent codebase scans from the terminal.

Code search, fast grep, and agent codebase scans from the terminal. Built by BurntSushi.

Task fit

code search, fast grep, and agent codebase scans from the terminal.

Lane

Review PRs, triage issues, inspect workflows, and keep repo work agent-safe.

Operator brief

Use rg for code search, fast grep, and agent codebase scans from the terminal.

Run `rg TODO src` and see what comes back.

Repository family

BurntSushi

First trust check

rg responds locally and is ready for the first real command.

Safe first loop

Install, verify, then run one real command.

GitHub review loop

Install command

$ brew install ripgrep

Operator pack

Copy or export the working notes for this CLI before handing it to an agent.

Verify

$ rg --version

rg responds locally and is ready for the first real command.

First real command

$ rg TODO src

First steps

  1. 01Install rg.
  2. 02Run `rg --version` first.
  3. 03Start with `rg TODO src`.
  4. 04Install the CLI and make sure it is on your PATH.

When to use / hold off when

Best for

code search, fast grep, and agent codebase scans from the terminal.

Use this when

You need shell utilities in both local dev and CI.

Hold off when

You don't work with shell utilities.

Trust and constraints

trusted100/100
Install readyTrusted
JSON outputNo
Non-interactiveYes
CI-friendlyYes

Why operators pick it

  • rg fits git & github well, especially for code search, fast grep, and agent codebase scans from the terminal.
  • 53,266 homebrew installs (30d).
  • Easy to automate.

Constraints

  • Output is mostly plain text.

Facts and links

Install withbrew
Homebrew installs (30d)53.3K
GitHub stars61.4K
LicenseUnlicense
UpdatedFeb 27, 2026
DocumentationOpenGitHubOpenWebsiteOpen