개인
Clidex - AI 에이전트를 위한 CLI 도구 검색
CLI 도구 검색 엔진 for AI Agents
- 기간
- 2026.03 ~ 진행 중2026.03 ~ 2026.11, 165커밋 (v0.5.0까지)
- 역할
- 1인 개발 / 오픈소스
- 팀
- 개인 프로젝트
- 상태
- 진행 중
- 인덱싱한 CLI 도구
- 5,000+Homebrew, awesome-cli-apps, toolleeo, npm, crates.io 등 통합
- CLI 도메인 시노님 매핑
- 41개

배경
AI 에이전트가 CLI 도구를 자연어로 검색·비교·설치할 수 있는 Rust 기반 인덱스. BM25 + 시노님 확장 + 퍼지 매칭 하이브리드 검색으로 recall을 보완하고, YAML/JSON 출력과 MCP 서버로 에이전트가 바로 호출할 수 있다.
한 일
주요 기능
하이브리드 검색 알고리즘
- BM25 필드별 가중치 (이름 3x, 태그/카테고리 2x, 설명 1x)
- 도메인 시노님 매핑 (search→find/grep/locate, http→web/api/curl 등)
- 퍼지 매칭 폴백 (nucleo-matcher): 오타/부분 매칭 대응
- GitHub stars 기반 인기도 보정 (비선형 정규화)
CLI 명령어 체계
- clidex "query": 자연어 도구 검색 (상위 10개)
- clidex info <name>: 도구 상세 정보
- clidex compare <names...>: 도구 비교 테이블
- clidex trending: 인기 도구 목록
- clidex update: GitHub Releases에서 인덱스 갱신
AI 에이전트 친화적 설계
- YAML/JSON 출력 포맷: LLM이 파싱하기 쉬운 구조
- MCP 서버(rmcp)로 에이전트에서 검색·조회 도구로 직접 호출
- 설치 명령어 통합 (brew, apt, cargo, npm 등)
- 도구별 docs/llms.txt 링크 제공
- Pretty/YAML/JSON 3가지 출력 모드
문제와 해결
- 검색 정확도와 recall 균형
- BM25 단독으로는 'find files' → 'fd' 같은 시노님 매칭 불가. 도메인 특화 시노님 확장 + 퍼지 매칭 하이브리드로 해결
- 인기도 편향 방지
- GitHub stars가 높은 도구가 관련성 낮은 쿼리에서도 상위 노출. 비선형 정규화 (10k stars 이상 diminishing returns)로 해결
결과
- 최소 바이너리 사이즈 최적화 (LTO + strip)
- 검색 지연: 20~28개 도구 픽스처에서 쿼리당 약 3ms, 5,277개 전체 인덱스에서 쿼리당 약 880ms
배운 점
- Rust 실전 프로젝트: clap, serde, tokio 활용
- 정보 검색 알고리즘: BM25 + 시노님 확장의 효과
- AI 에이전트 도구 설계: 구조화된 출력의 중요성
- CLI 도구 생태계 이해: 패키지 매니저별 설치 방식
기술 스택
- 언어
- Rust (2021 edition)
- 검색
- BM25 (bm25 crate)nucleo-matcher
- CLI
- clap 4 (derive)colored 3
- MCP
- rmcp (MCP 서버)
- 직렬화
- serdeserde_norwayserde_json
- 네트워크
- reqwest 0.13 (rustls)tokio 1
- 빌드
- LTOstrip symbolsopt-level = 'z'