Skip to content
CAI
Software that uses CAICheck a score

BurntSushi/ripgrep

65.2

Adequate · 14 November 2026

43.8k

lines of production code

Rust

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add Homebrew formula for ripgrep-bin

Users can now install the ripgrep binary via Homebrew using the new \ripgrep-bin\ formula. This formula provides version 15.0.0 of the tool for both macOS and Linux (musl), installs the \rg\ binary along with its man page, and includes shell completions for Bash and Zsh. It is configured to conflict with the standard \ripgrep\ package to prevent installation conflicts.

pkg/brew · high confidence

Add benchmark results for ripgrep without memory-mapped I/O

This change adds a new benchmark entry for ripgrep (\rg (no mmap)\) to the \subtitles\_en\_literal\ test case, allowing users to compare performance when the \--mmap\ flag is disabled. The commit also includes a setup guide (\README.SETUP\) for reproducing these benchmarks on an Ubuntu 16.04 EC2 instance and provides the raw CSV data and summary statistics for the run.

benchsuite/runs/2016-09-20-ubuntu1604-ec2 · high confidence

Users can now use named aliases (such as \cursor\, \vscode\, \kitty\, \macvim\, and \textmate\) for the \--hyperlink-format\ option instead of writing raw format strings. The printer resolves these aliases to their corresponding URL schemes, with \default\ providing a platform-aware \file://\ format and \none\ explicitly disabling hyperlinks.

crates/printer/src/hyperlink · high confidence

Add regex matcher crate with capture group interpolation and match indexing

The \crates/matcher/src\ directory now contains the \grep-matcher\ crate, introducing a \Matcher\ trait for line-oriented text search and a new \interpolate\ module. This module enables users to perform replacement operations using capture group references (e.g., \$1\, \$name\) within regex matches, supporting both numeric and named capture groups. Additionally, the crate provides a \Match\ struct that allows direct indexing of byte slices and strings using match ranges, facilitating efficient extraction of matched text segments.

crates/matcher/src · high confidence

Added Arch Linux benchmark results for text-search tools

Added a new benchmark run for the Arch Linux 'cheetah' environment, containing raw timing data and summary statistics for various text-search tools (rg, ag, git grep, pt, sift, ucg, grep) across multiple search patterns including literal strings, regexes, and Unicode characters.

benchsuite/runs/2016-09-22-archlinux-cheetah · high confidence

Added Ubuntu 16.04 benchmark results and setup instructions

This change adds a new benchmark run directory for Ubuntu 16.04 on EC2 c3.2xlarge instances. It includes a README.SETUP file detailing the environment configuration (including specific versions of ripgrep, the\_silver\_searcher, ucg, pt, and sift) and two data files (raw.csv and summary) containing performance metrics for various search tools across different pattern types and datasets.

benchsuite/runs/2016-09-17-ubuntu1604-ec2 · high confidence

Added benchmark results for ugrep on Arch Linux (2020-10-14)

This update adds a new set of benchmark results captured on an Arch Linux system, specifically including performance data for ugrep (version 3.0.2) alongside ripgrep, ag, git grep, and GNU grep. The entry provides the raw CSV data and a summary of execution times across various search patterns (literal, regex, Unicode, case-insensitive) to allow comparison of ugrep's performance against other tools in this specific environment.

benchsuite/runs/2020-10-14-archlinux-frink · high confidence

Added parallel and walkdir comparison example

A new example file \walk.rs\ has been added to demonstrate directory walking capabilities. It allows users to compare the \ignore\ crate's parallel and sequential walkers against the standard \walkdir\ crate by passing command-line arguments (\parallel\ or \walkdir\). This helps users understand performance and usage differences between the libraries.

crates/ignore/examples · high confidence

Initial release of the grep-searcher crate

The \grep-searcher\ crate is introduced as a new component providing line-oriented search capabilities with optional multi-line support. It exposes a \Searcher\ API that reads bytes from sources, applies pattern matching via \Matcher\ implementations (such as \grep-regex\), and reports results through \Sink\ handlers. The crate includes core modules for line buffering, line iteration, and sink management, along with an example demonstrating how to search stdin using a regex pattern.

crates/searcher/src · high confidence

Introduce PCRE2-based regex matcher implementation

This change adds a new implementation of the \grep-matcher\ \Matcher\ trait using the PCRE2 library, located in the \crates/pcre2\ directory. It introduces \RegexMatcherBuilder\ to configure pattern compilation (supporting options like case-insensitivity, smart-case, fixed strings, and word boundaries) and \RegexMatcher\ to perform the actual matching. The module also defines a dedicated \Error\ type to handle regex parsing and compilation failures, providing a concrete backend for regex-based search operations.

crates/pcre2/src · high confidence

Introduce benchsuite CLI benchmark runner

Adds a new Python-based benchmarking tool (\benchsuite/benchsuite\) designed to compare the performance of command-line search utilities such as ripgrep, ag, git grep, ugrep, and grep. The tool executes standardized test suites against specific corpora (including Linux source code and OpenSubtitles) to measure execution speed under various conditions, including literal searches, case-insensitive matching, and regex patterns.

benchsuite · high confidence

Introduction of the \`grep\` library crate

A new \grep\ crate has been added to the repository, serving as a high-level facade that re-exports the core components of ripgrep (cli, matcher, printer, regex, searcher, and optionally pcre2). This change makes ripgrep's search functionality available as a reusable library for external consumers, accompanied by documentation, dual MIT/Unlicense licensing, and a simple example demonstrating how to integrate the search API.

crates/grep · high confidence

New CLI utility library with improved error handling and platform support

The \crates/cli/src\ directory now contains a new \grep-cli\ library providing common routines for command-line applications. This includes a \DecompressionMatcher\ for handling out-of-process decompression of compressed files, a \CommandReader\ for streaming process output with improved stderr error reporting, and utilities for parsing human-readable sizes (e.g., '2M') and escaping/unescaping arbitrary bytes. The library also introduces a \hostname\ function for retrieving the system name and improves stdin detection heuristics using \std::io::IsTerminal\. Additionally, the \StandardStream\ writer now supports hyperlinks via \termcolor::HyperlinkSpec\.

crates/cli/src · high confidence

New script to extract Rust examples from documentation

A new executable script, scripts/copy-examples, has been added to automate the extraction of Rust code examples from source files. The script parses a specified Rust file (defaulting to src/cookbook.rs) for code blocks marked with specific comment patterns, strips the comment markers, and writes the resulting code into individual files within a target directory (defaulting to grep/examples). This tool simplifies the process of maintaining separate example files from embedded documentation.

scripts · high confidence

New shell completion scripts for Bash, Fish, PowerShell, and Zsh

Ripgrep now provides generated shell completion scripts for Bash, Fish, and PowerShell, alongside a hand-maintained Zsh completion script. These completions cover all CLI flags, including negated options, file paths, encodings, and type-specific choices, improving the interactive command-line experience across major shells.

crates/core/flags/complete · high confidence

Ripgrep's ignore crate is restructured into a dedicated Rust crate

The file-matching and directory-walking logic previously embedded in the ripgrep binary has been extracted into a standalone \crates/ignore\ crate. This change introduces a public API for recursive directory traversal that respects \.gitignore\ files, custom ignore rules, and file-type filters, along with an incremental matcher for checking individual paths against hierarchical ignore rules without full traversal. The crate exposes modules for gitignore parsing, file-type definitions, and override globs, allowing external tools to reuse ripgrep's filtering logic.

crates/ignore/src · high confidence

Removals

Removal of legacy 'rep' prototype

The legacy 'rep' prototype implementation in src/main.rs has been removed. This file contained a standalone, single-threaded grep-like tool using Docopt for argument parsing and internal regex execution, which is no longer part of the codebase.

src · high confidence

Architecture

Printer logic extracted into the grep-printer crate

The output formatting logic previously located in the main repository has been moved into the new \grep-printer\ crate. This change introduces dedicated modules for standard output (\standard.rs\), JSON output (\json.rs\), and summary statistics (\summary.rs\), along with supporting utilities for color specifications, hyperlinking, and path printing. Users relying on the previous internal structure will need to update their imports to use the new \grep\_printer\ crate, which now provides the \Standard\, \JSON\, and \Summary\ printer implementations.

crates/printer/src · high confidence

Behavioural changes

Add AI usage policy for contributors

The project now enforces an AI usage policy requiring that all contributions be explained in the contributor's own words and prohibiting autonomous agents from submitting code or responses. This policy is documented in the new AI\_POLICY.md file and referenced in CONTRIBUTING.md, with violations subject to closure without notice.

(repo-wide) · high confidence

Arch Linux Cheetah benchmark results for rg 0.2

This entry adds the raw and summary benchmark data for the 'archlinux-cheetah' environment, capturing performance metrics for the \rg\ (ripgrep) tool after updating to version 0.2. The dataset includes execution times and line counts for various search patterns (literal, regex, Unicode) across Linux kernel sources and subtitle files, comparing default behavior against options like \--no-ignore\, \--mmap\, and case-insensitivity.

benchsuite/runs/2016-12-30-archlinux-cheetah · high confidence

Automated generation of help and man page documentation

Ripgrep now includes a new documentation generation system in the \crates/core/flags/doc\ module that automatically produces the short help (\-h\), long help (\--help\), and man page (\man\) output from the central flag definitions. This change introduces dedicated templates for each format and logic to handle custom markup (such as \ lag{}\ and \ lag-negate{}\), ensuring that documentation stays consistent with the CLI interface. The version string generation has also been updated to include PCRE2 availability and SIMD feature details, providing users with more comprehensive build information in the help output.

crates/core/flags/doc · high confidence

Crates reorganized into the \`crates/\` directory with added license and documentation files

The repository structure has been updated to move all source code into a \crates/\ directory. This change includes the addition of MIT and Unlicense license files, as well as README documentation, for the \grep-cli\, \ignore\, \grep-matcher\, \grep-pcre2\, \grep-printer\, \grep-regex\, and \grep-searcher\ crates.

(repo-wide) · high confidence

New CI utility and validation scripts for builds and completions

This change introduces several new shell scripts in the \ci/\ directory to support the build and release process. \sha256-releases\ automates the generation of SHA-256 checksums for Linux, Darwin, and source releases. \test-complete\ validates that the Zsh completion options match the \--help\ output to ensure consistency. \ubuntu-install-packages\ handles dependency installation in stripped environments, and \utils.sh\ provides shared helper functions for detecting architectures (x86, ARM), OS types, and build targets (musl vs. gnu).

ci · high confidence

New modular CLI flag system with config file support

The command-line interface has been restructured into a new modular flag system located in \crates/core/flags\. This change introduces a dedicated config file reader (\config.rs\) that parses arguments from the path specified by the \RIPGREP\_CONFIG\_PATH\ environment variable, prepending them to CLI arguments. The flag definitions are now centralized in \defs.rs\ using a \Flag\ trait, with low-level parsing in \lowargs.rs\ and high-level argument construction in \hiargs.rs\. This refactoring enables better separation of concerns for flag parsing, validation, and documentation generation, while maintaining backward compatibility with existing flags.

crates/core/flags · high confidence

New regex matcher implementation with optimized literal extraction

The \crates/regex/src\ module now implements the \grep-matcher\ Matcher trait using a new internal architecture. This change introduces a dedicated AST analysis system to support smart-case matching and adds an inner literal extraction engine that identifies fixed strings within patterns to accelerate search performance. It also includes a line-terminator stripping mechanism to prevent matches across line boundaries when multiline mode is disabled, and enforces banned-byte checks to reject patterns containing disallowed characters like NUL.

crates/regex/src · high confidence

Ripgrep core restructured into a dedicated crate with new search and output handling

The ripgrep core logic has been moved into a new \crates/core\ crate, consolidating the main entry point, CLI argument parsing, and the glue code that coordinates the search components. This change introduces a \Haystack\ abstraction to manage search targets (files, stdin, directories) and applies explicit filtering logic to determine which entries are actually searched. Output handling is updated to prefix non-fatal error messages with 'rg: ' and lock stdout before printing to stderr to prevent interleaving in parallel execution. Additionally, the search worker now conditionally builds decompression readers only when needed, and the application uses the \tikv-jemallocator\ allocator on 64-bit musl targets to improve performance.

crates/core · high confidence

Searcher engine refactored with new core, glue, and mmap modules

The search engine internals have been restructured into dedicated modules (core, glue, mmap) to improve code organization and performance. This change introduces UTF-8 BOM sniffing for automatic encoding detection, re-enables memory-mapped file reading on 32-bit architectures, and adds a new \--stop-on-nonmatch\ CLI flag to halt searching after a non-matching line. It also fixes several bugs related to context handling, line buffering, and NUL character processing.

crates/searcher/src/searcher · high confidence

globset: migrate to regex-automata and add serde support

The globset crate has been refactored to use the regex-automata library instead of the older regex crate, which improves matching performance and reduces memory usage. Additionally, optional serde support has been added, allowing Glob and GlobSet instances to be serialized and deserialized from formats like JSON when the 'serde1' feature is enabled.

crates/globset/src · high confidence

Test coverage

Added Python workspace discovery benchmarks; Added fuzz testing for glob pattern consistency; Added tests for gitignore BOM handling and path matching; Added tests for the grep-matcher crate; Integration test suite for binary file handling and core features.

Dependencies

ripgrep 15.2.0: Rust 2024 edition, MSRV 1.96, and dependency updates

The ripgrep CLI tool has been updated to version 15.2.0, migrating the codebase to the Rust 2024 edition and raising the minimum supported Rust version (MSRV) to 1.96. This release replaces the clap argument parser with lexopt and updates several core dependencies, including bstr to 1.7.0, termcolor to 1.4.0, and the grep sub-crates (grep, ignore, globset, grep-cli, grep-searcher, grep-regex, grep-printer, grep-matcher, grep-pcre2) to their latest versions. The build configuration now includes a release-lto profile for optimized binaries and updated Debian packaging metadata.

(dependencies) · high confidence

Housekeeping

Add license files and documentation for globset crate; Added benchmark results for Arch Linux Cheetah with glibc/jemalloc, glibc/system, and musl/jemalloc; Added benchmark run for Arch Linux (2022-12-16); Updated benchmark results for Arch Linux (2018-01-08).

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 69 → 65 (-3.5)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 70 → 60 (-10.2)
  • Architecture 98 → 98 (+0.0)
  • Maturity 65 → 65 (-0.2)
  • Readiness 64 → 65 (+0.8)
  • Security 83 → 75 (-8.3)
  • Performance 90 → 90 (+0.0)

Resolved (8)

  • Duplicated block (5 lines × 2) (crates/printer/src/jsont.rs)
  • Duplicated block (6 lines × 2) (crates/printer/src/standard.rs)
  • Duplicated block (6 lines × 2) (crates/printer/src/standard.rs)
  • Duplicated block (9 lines × 2) (crates/printer/src/standard.rs)
  • Flaky test: ignore.incremental::tests::cached_parent_matcher_is_used_for_directory
  • Flaky test: ignore.incremental::tests::whitelisted_hidden_directory_allows_descendants
  • No ADRs found
  • Off-boarding risk: anonymized user #1

New (60)

  • Duplicated block (7 lines × 2) (crates/printer/src/standard.rs)
  • Duplicated block (9 lines × 2) (crates/printer/src/standard.rs)
  • Edited copies of one member (3 members, 12+ corresponding lines) (crates/printer/src/json.rs)
  • Edited copies of one member (3 members, 14+ corresponding lines) (crates/core/flags/lowargs.rs)
  • Edited copies of one member (3 members, 24+ corresponding lines) (crates/searcher/src/searcher/core.rs)
  • Edited copies of one member (3 members, 7+ corresponding lines) (crates/printer/src/path.rs)
  • Edited copies of one member (3 members, 8+ corresponding lines) (crates/printer/src/standard.rs)
  • Edited copy of a member (10 corresponding lines) (crates/core/search.rs)
  • Edited copy of a member (10 corresponding lines) (crates/ignore/src/types.rs)
  • Edited copy of a member (10 corresponding lines) (crates/matcher/src/lib.rs)
  • Edited copy of a member (10 corresponding lines) (crates/pcre2/src/matcher.rs)
  • Edited copy of a member (11 corresponding lines) (crates/globset/src/glob.rs)
  • Edited copy of a member (11 corresponding lines) (crates/ignore/src/walk.rs)
  • Edited copy of a member (11 corresponding lines) (crates/printer/src/summary.rs)
  • Edited copy of a member (12 corresponding lines) (crates/globset/src/lib.rs)
  • Edited copy of a member (13 corresponding lines) (crates/regex/src/literal.rs)
  • Edited copy of a member (14 corresponding lines) (crates/searcher/src/sink.rs)
  • Edited copy of a member (15 corresponding lines) (crates/core/flags/defs.rs)
  • Edited copy of a member (15 corresponding lines) (crates/globset/src/lib.rs)
  • Edited copy of a member (15 corresponding lines) (crates/globset/src/lib.rs)
  • …and 40 more

Changes since last survey

  • 6 commits — 6 feature/other, 0 fixes

By area

  • crates/ignore — 3 commits
  • (root) — 2 commits
  • crates/globset — 1 commit

Notable commits

  • change: globset-0.4.21
  • change: globset: match filename-only regexes against basenames
  • change: ignore-0.4.34
  • change: ignore: respect custom filters with a maximum file size (#3599)
  • change: ignore: respect linked worktree excludes without requiring Git
  • change: ignore: reuse incremental matchers for directories without rules

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

BurntSushi/ripgrep was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 178cc027e283fd965cb72d0a7395b219eada170c — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-36d4cd83012f.