syshin0116/clidex

<p align="center" <img src="assets/logo.gif" alt="Clidex" width="500" </p <p align="center" <strongCLI tool discovery for AI agents</strong </p <p align="center" Search, compare, and install 5,294+ command-line tools with structured YAML/JSON output. </p <p align="center" <a href="https://github.com/syshin0116/clidex/actions/workflows/ci.yml"<img src="https://github.com/syshin0116/clidex/actions/workflows/ci.yml/badge.svg" alt="CI"</a <a href="https://github.com/syshin0116/clidex/releases/latest"<img src="https://img.shields.io/github/v/release/syshin0116/clidex" alt="Release"</a <a href="https://crates.io/crates/clidex"<img src="https://img.shields.io/crates/v/clidex" alt="crates.io"</a <a href="https://github.com/syshin0116/clidex/blob/main/LICENSE"<img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"</a </p

---

Quickstart

# Install
cargo install clidex            # or: curl -fsSL https://raw.githubusercontent.com/syshin0116/clidex/main/install.sh | sh

# Search (auto-downloads index on first run)
clidex "csv to json"            # Pretty output in terminal, YAML in pipes
clidex "csv to json" --json     # JSON output
clidex info jq                  # Detailed tool info
clidex compare jq dasel yq      # Side-by-side comparison

---

Why Clidex?

AI agents like Claude Code, Codex, and Gemini CLI can run terminal commands — but they don't know which tools exist beyond the basics. An agent uses grep when ripgrep is 10x faster, or find when fd is simpler.

Clidex bridges this gap. It's a local CLI that returns structured metadata about CLI tools: what they do, how to install them, and where to find docs. No web search API calls, no HTML parsing, no cost — just a fast local lookup.

<p align="center" <img src="assets/demo.gif" alt="clidex demo" width="600" </p

What makes it different

| | awesome-cli-apps / cli-anything | Clidex | |--|------|------| | Target user | Humans | AI agents (+ humans) | | Output | Markdown / TUI | YAML / JSON / Pretty | | Install info | Links only | brew install jq — ready to run | | Docs access | Click a link | llms.txt URL for agents to read | | Pipeline | No | clidex ... \| nexttool (YAML in pipes) | | Compare | No | clidex compare jq dasel yq |

---

Installation

With Cargo (all platforms)

cargo install clidex

Pre-built binaries

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/syshin0116/clidex/main/install.sh | sh