菜单
Local markdown search engine CLI. Use when searching notes, querying documents, managing collections, indexing, embedding, or retrieving document content. Also use when ir search, ir update, ir embed, ir collection, ir status, ir daemon, ir get.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Creates ast-grep patterns for structural code search. Use when finding functions/classes by structure, refactoring code, or when grep returns too many false positives.
Builds Claude Agent SDK agents in Python. Use when creating custom tools, hooks, sub-agents, or MCP integrations with the Agent SDK. Python 에이전트 구축 시 사용.
Graph-based code review with Tree-sitter knowledge graph. Use when reviewing code changes, PRs, or exploring blast radius of modifications in projects with code-review-graph installed (.code-review-graph/ exists). Also use for initial setup of code-review-graph in a new project. Do NOT use for checklist-based reviews without graph (use code-review instead), or for security-focused reviews (use security instead).
Code review hub. 타입 안전성 (TypeScript, Python), lint 감사, 죽은 코드, 테스트 품질 리뷰 (smell, overfitting, 커버리지, 통합/E2E), Terraform/IaC 안전성 (lifecycle, state, credentials). 병렬 에이전트 모드로 다각적 분석 지원. 코드 리뷰, 타입 체크, lint, 테스트 리뷰, terraform, IaC.
데이터 조사/분석 파이프라인 생성. 데이터 수집 -> Python 분석/차트(matplotlib) -> HTML 리포트. Use when 데이터 분석, 조사, investigation, 이상 탐지, 패턴 분석, 리포트 생성, 차트 시각화, 데이터 수집 파이프라인 구축. Also use when 데이터를 모아서 분석하고 보고서를 만드는 작업. Do NOT use for 단순 DB 조회 (use gandy), 단순 차트 하나 (use diagram).
코드 작업 완료 후 변경 내러티브 문서 생성. 변경 요약, 설계 판단 근거, 학습 포인트를 vault에 기록. Vault 위치/매핑은 `documentation` skill, 형식은 `obsidian-write` 참조. Use when completing code work, after PR creation, reviewing what was done, or wanting to document changes for learning. /debrief, 작업 정리, 변경 기록, 회고.
| name | ir |
| description | Local markdown search engine CLI. Use when searching notes, querying documents, managing collections, indexing, embedding, or retrieving document content. Also use when ir search, ir update, ir embed, ir collection, ir status, ir daemon, ir get. |
| allowed-tools | Bash(ir:*) |
로컬 마크다운 문서를 인덱싱하고 검색하는 CLI 도구. Collection 기반 관리, BM25/Vector/Hybrid 검색 지원.
!ir status 2>/dev/null || echo "ir not available"
ir search "question" # Hybrid (기본, 최고 품질)
ir search --mode bm25 "keywords" # BM25 only (빠름, no LLM)
ir search --mode vector "question" # Vector only
--mode <MODE> # bm25 | vector | hybrid [default: hybrid]
-n <num> # 결과 개수 (기본 10)
--min-score <num> # 점수 임계값
-c, --collection <name> # 특정 컬렉션만 검색
--full # 전체 문서 내용
--files # docid,score,filepath,context 출력
--json # JSON 출력
--md # Markdown 출력
--csv # CSV 출력
--all # 전체 결과 (최대 4096)
-v, --verbose # 파이프라인 결정 및 타이밍
ir get "#abc123" # By docid
ir get notes/meeting.md:50 -l 100 # 특정 라인부터
ir collection list # 목록
ir collection add ~/notes --name notes # 추가
ir collection remove <name> # 삭제
ir collection rename <old> <new> # 이름 변경
ir collection set-path <name> <path> # 경로 변경
ir update # 전체 재인덱싱
ir update <collection> # 특정 컬렉션만
ir update --pull # git pull 후 재인덱싱
ir embed # 벡터 임베딩 생성
ir embed <collection> # 특정 컬렉션만
ir daemon start # 검색 데몬 시작 (모델 warm)
ir daemon stop # 데몬 중지
ir daemon status # 데몬 상태
ir mcp # MCP 서버 시작
ir mcp --http <PORT> # HTTP MCP 서버
User: "배포 관련 노트 찾아줘"
-> ir search "배포 방법 deploy" -n 10
-> 결과 요약 -> 필요 시 ir get "#docid"로 상세 조회
User: "이 프로젝트 문서도 검색되게 해줘"
-> ir collection add ~/pj-foo/docs --name pj-foo
-> ir update pj-foo && ir embed pj-foo
-> ir status 로 확인
User: "회의록에서 프로젝트 타임라인 찾아줘"
-> ir search "프로젝트 일정과 마일스톤" -c meetings -n 10
--mode bm25, 최고 품질 -> 기본 hybrid-c 옵션으로 범위를 좁히면 노이즈 감소ir update && ir embed 실행--json/--files 출력으로 후처리 연결