ratcrate-cli is a fast, terminal-native command-line tool built in Rust for discovering, searching, and getting information about crates within the Ratatui ecosystem. It uses a smart caching strategy to provide near-instant results directly in your terminal. The project follows a standard Rust CLI structure, ensuring clear separation of responsibilities:
Tip
For more information, read "The book"
- Offline First: Caches data locally and only downloads when stale (older than 1 day) or forced.
- Fuzzy Search: Filter crates by name or description using a command-line query.
- Interactive Mode: Seamless integration with
fzffor interactive selection and viewing of crate details. - Statistical Breakdown: Quick summary of total, core, and community packages (
-t). - Flexible Output: Supports both a clean, colored list view and an optional structured table view (
--table).
- Rust Toolchain: You need the latest stable Rust version installed via rustup.
- fzf (Optional): Required for the interactive mode (
-f).
Once the package is published, you can install it globally:
$> cargo install ratcrate-cli$> brew install rvbug/tap/ratcrate-cliHomebrew cn be installed via
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Clone the repository and build the project using Cargo:
$> git clone [https://github.com/ratcrate/ratcrate-cli.git](https://github.com/ratcrate/ratcrate-cli.git)
$> cd ratcrate-cli
$> cargo install --path Run ratcrate-cli --help for a full list of options.
| Option | Description |
|---|---|
-h, --help |
Display help information. |
-q, --query <QUERY> |
Search term to filter packages |
-c, --cache-info |
Show cache info |
-l, --limit <LIMIT> |
Limit number of results to show [default: 10] |
-r, --refresh |
Force re-download of remote JSON to cache |
-f, --fzf |
Enable interactive mode with fzf. |
-t, --total |
Display total number of crates. |
-V, --version |
Display the version number. |
-h, --help |
Display help information. |
--table |
Table view (requires compiling with --features table) |
$ ratcrate-cli -t
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Loaded from cache
Total Crates Overview
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Total Crates: 1686
Core Libraries: 2
Community Packages: 1684
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Data generated at: 2025-12-04T06:10:38.648089+00:00$> cargo run --features=table -- --table
ratcrate (discover ratatui crates)
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Loaded from cache
+-----------------+---------+---------------------------------------------------------------+-----------+-----------------------------------------------------+
| name | version | description | downloads | repo |
+-----------------+---------+---------------------------------------------------------------+-----------+-----------------------------------------------------+
| ratatui-macros | v0.6.0 | Macros for Ratatui | 252104 | https://github.com/ratatui/ratatui |
+-----------------+---------+---------------------------------------------------------------+-----------+-----------------------------------------------------+
| ratatui-widgets | v0.2.2 | A collection of Ratatui widgets for building terminal user i⦠| 123671 | https://github.com/ratatui/ratatui |
+-----------------+---------+---------------------------------------------------------------+-----------+-----------------------------------------------------+
| CLI-Rhythm | v1.0.1 | A simple and functional CLI music player. | 5092 | https://github.com/Arklingh/CLI-Rhythm |
+-----------------+---------+---------------------------------------------------------------+-----------+-----------------------------------------------------+$> cargo run -- -q parser
ratcrate (discover ratatui crates)
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Loaded from cache
Results: 8 / 8
Query: parser
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
1. codex_usage v0.1.1
Codex and Claude Code telemetry/usage parser, aggregate JSONL events
into CodeAnalysis results
Downloads: 262 Repo: https://github.com/Mai0313/codex_usage
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
2. keybinds v0.2.0
Platform&Framework-agnostic key binding (keyboard shortcut) dispatcher,
parser, and generator written in Safe Rust.
Downloads: 9140 Repo: https://github.com/rhysd/keybinds-rs- "Try" mode
- Debian Support
Contributions are welcome! If you have suggestions or find a bug, please open an issue or submit a pull request.
This project is licensed under the MIT License. See the LICENSE file for details.
