clidex/llms.txt at main · syshin0116/clidex · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
# Clidex

> CLI tool discovery for AI agents. Search, compare, and install 5,000+ command-line tools with structured YAML/JSON output.

Clidex indexes CLI tools from Homebrew, awesome-cli-apps, toolleeo, npm, and crates.io. It returns structured YAML/JSON with install commands, GitHub stars, and documentation links. Designed for AI agents that need to discover and install CLI tools programmatically.

## Installation

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

clidex update    # Download the tool index
```

## Commands

### Search

```bash
clidex "json processor"           # YAML output (default, agent-friendly)
clidex "json processor" --pretty  # Human-friendly table
clidex "json processor" --json    # JSON output
clidex "file manager" -n 3        # Top 3 results
```

### Tool info

```bash
clidex info jq                    # Full metadata
clidex info jq --pretty
```

### Compare

```bash
clidex compare jq dasel yq        # Side-by-side comparison
```

### Browse

```bash
clidex trending -n 10             # Most popular by stars
clidex trending --category git
clidex --categories               # List all categories
clidex --category docker          # Filter by category
```

### Update

```bash
clidex update                     # Download latest index
clidex stats                      # Index statistics
```

## Output Formats

- *(default)*: YAML, structured and agent-friendly
- `--pretty`: Human-friendly table
- `--json`: Machine-parseable JSON

## Output Schema

```yaml
name: string            # Tool name
binary: string?         # Binary name (if different)
desc: string            # One-line description
category: string        # e.g. "Files and Directories > Search"
tags: [string]          # Search tags
install:                # Install commands by package manager
  brew: string?
  cargo: string?
  npm: string?
  pipx: string?
stars: number?          # GitHub stars
brew_installs_365d: number?  # Homebrew annual installs (365-day)
links:
  repo: string?         # GitHub repository
  homepage: string?     # Project homepage
  docs: string?         # Documentation URL
  llms_txt: string?     # llms.txt URL for LLM-readable docs
```

## Data Sources

Updated daily via GitHub Actions:

- awesome-cli-apps (curated, ~473 tools)
- toolleeo/cli-apps (structured CSV, ~2,200 tools)
- Homebrew formulae (~8,200 packages)
- Homebrew Cask (terminal emulators, GUI+CLI apps)
- npm registry (CLI packages with bin field)
- crates.io (Rust CLI tools + category-based discovery)
- PyPI (Python CLI tools via pipx)
- GitHub API (stars, last updated)
- Homebrew install-on-request analytics (popularity)

## Search Algorithm

BM25 with field weighting + synonym expansion (30+ groups) + intent coverage scoring + popularity boost (GitHub stars, Homebrew installs) + fuzzy matching (nucleo subsequence + edit distance for typo correction) + confidence gates. Optional Model2Vec semantic search via Reciprocal Rank Fusion.

## Links

- Repo: <https://github.com/syshin0116/clidex>
- Crates.io: <https://crates.io/crates/clidex>
- Index: <https://github.com/syshin0116/clidex/releases/download/index/index.yaml>