Syshin0116 홈
프로젝트 목록

개인

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개
Clidex 터미널 데모

배경

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 서버)
직렬화
serde
serde_norway
serde_json
네트워크
reqwest 0.13 (rustls)
tokio 1
빌드
LTO
strip symbols
opt-level = 'z'

관련 글