Show GN: ccinv - Claude Code에 뭐가 깔려있는지 한눈에 보는 CLI
Claude Code를 오래 쓰면 하나씩 궁금해진다. 내 프로젝트에 어떤 스킬이 등록되어 있고, 어디까지 확장했는지 한눈에 보고 싶을 때가 있다. 보통은 ~/.claude/ 폴더를 뒤지고, 설정 파일을 일일이 열어보고, 플러그인 마켓플레이스를 브라우저에서 확인하는 번거로운 과정을 거쳐야 했다. 이 문제를 한 방에 해결하는 도구가 등장했다. ccinv다.
ccinv란 무엇인가
ccinv는 Claude Code에 설치된 리소스를 한 화면에 보여주는 인벤토리 대시보드 도구다. 명령어, 스킬, 에이전트, 훅, MCP 서버, 플러그인을 user · project · local · plugin 네 가지 스코프에 걸쳐 모두 스캔한다. 핵심 특징은 세 가지다.
• Zero LLM: GPT 호출 없이 파일 시스템만 읽는다
• Zero 서버: 별도 백엔드 없이 로컬에서 동작한다
• Zero 런타임 의존성: Node.js만 있으면 된다
GitHub 저장소(Sianmin/ccinv)의 설명에 따르면, Claude Code는 설정을 ~/.claude/와 settings.local.json 등에 분산 저장한다. 기존 대시보드인 SkillDeck이나 ClaudHub는 사용자 스코프만 스캔했고, ccinv는 이 세 곳을 모두커버리지한다.
설치와 기본 사용법
설치는 한 줄이면 충분하다.
npx ccinv별도 설치나 설정이 필요 없다. 기본 출력은 터미널 컬러 테이블이다.
출력 형식 세 가지
ccinv는 목적에 따라 세 가지 출력 형식을 제공한다.
1. 터미널 테이블 (기본)
npx ccinv애ANSI 색상이 적용된 표 형태로 리소스를 출력한다. stdout이 TTY가 아니거나 NO_COLOR 환경 변수가 설정되면 자동으로 색상이 비활성화된다.
2. HTML 대시보드
npx ccinv --html단일 파일 HTML 대시보드를 생성하고 브라우저에서 자동으로 연다. --output 옵션으로 파일 경로를 지정하고, --no-open으로 자동 열기를 비활성화할 수 있다.
ccinv --html --output ./ccinv-report.html --no-open3. JSON (스크립팅용)
ccinv --jsonjq와 조합하면 강력한 필터링이 가능하다.
# 플러그인이 제공하는 에이전트 수 세기ccinv --json | jq '[.agents[] | select(.scope == "plugin")] | length'# 프로젝트 스코프 스킬 목록ccinv --json | jq -r '.skills[] | select(.scope == "project") | .name'스캔 대상 리소스
ccinv는 아래 여섯 가지 리소스 타입을 스캔한다.
| 리소스 | User | Project | Local | Plugin |
|---|---|---|---|---|
| Commands | ~/.claude/commands/.md | — | marketplaces//plugins//commands/*.md | |
| Skills | ~/.claude/skills//SKILL.md | — | marketplaces//plugins//skills/*/SKILL.md | |
| Agents | ~/.claude/agents/.md | — | marketplaces//plugins//agents/*.md | |
| Hooks | ~/.claude/settings.json | — | ||
| MCP | ~/.claude.json, ~/.claude/settings.json | — | ||
| Plugins | — | — | — | ~/.claude/plugins/marketplaces//plugins/ |
프로젝트 루트는 현재 디렉토리에서 위로 올라가며 .claude/ 폴더를 발견할 때까지 탐색한다.
필터링 옵션
--scope 옵션으로 특정 스코프만 출력할 수 있다.
ccinv --scope user,project플러그인 스코프를 숨기려면 --no-plugins을 사용한다.
ccinv --no-plugins--cwd로 작업 디렉터리를 지정할 수도 있다.
ccinv --cwd /path/to/project왜 유용한가
ccinv가 해결하는 근본적인 문제는 정보의 분산이다. Claude Code는 강력하지만 설정을 한 곳에 모아 보여주는 UI가 없다. 개발자가 자신의 환경을 파악하려면 여러 경로를 직접 찾아봐야 한다.
기존 대시보드(SkillDeck, ClaudHub)가 사용자 스코프만커버리지했던 이유는, 그것만으로도 충분히 복잡했기 때문이다. ccinv는 여기에 프로젝트 스코프와 로컬 스코프, 그리고 플러그인까지 확장했다. 파일 시스템 읽기만으로 구현 가능하기 때문에 LLM 비용도 없고 응답 속도도 빠르다.
ccusage에서 영감을 받았다는 점도 눈에 띈다. ccusage가 "얼마를 쓰고 있는지" 보여주면, ccinv는 "무엇이 설치되어 있는지" 보여준다. 같은 설계 철학이다.
유사 도구와의 비교
| 도구 | 커버리지 | 출력 형식 | LLM 필요 | 서버 |
|---|---|---|---|---|
| ccinv | User + Project + Local + Plugin | Table, HTML, JSON | ✗ | ✗ |
| SkillDeck | User만 | Web UI | ✗ | ✗ |
| ClaudHub | User만 | Web UI | ✗ | ✗ |
| ccusage | 사용량 추적 | Table, CSV | ✗ | ✗ |
ccinv가 가장 넓은커버리지를, 동시에 가장경이 구현이다.
사용 시 고려사항
현재 버전은 v0.1.0(initial release)이며, macOS에서만 테스트된 상태다. Linux와 Windows는 공식적으로 테스트되지 않았지만, Node의 크로스 플랫폼 API(os, path, fs/promises)만 사용하기 때문에 동작할 가능성이 높다.
터미널 색상은 stdout이 TTY가 아닐 때 자동으로 비활성화되므로, CI 환경이나 스크립트 내에서 사용해도 깔끔한 출력을 기대할 수 있다.
tags: Claude Code, CLI 도구, 개발자 도구, ccinv, AI 에이전트, 인벤토리, GeekNews, Show GN
정리
ccinv는 Claude Code를 쓰면서 "나한테 뭐가 다 깔려 있지?"라는 질문에 답해주는 도구다. 설정이 분산된 Claude Code 환경에서 스킬, 에이전트, 훅, MCP, 플러그인을 한눈에 파악하고 싶다면, npx ccinv 한 번이면 충분하다. 별도 설치 없이 바로 쓸 수 있다는 점이 가장 매력적이다.
📚 출처
📚 출처
'AI 뉴스' 카테고리의 다른 글
| VerbalCoding: Discord 음성으로 AI 코딩 에이전트와 대화하기 (0) | 2026.05.11 |
|---|---|
| AlphaEvolve: 여러 분야로 영향력을 확장하는 Gemini 기반 코딩 에이전트 (0) | 2026.05.10 |
| 클로드 코드 사용하기: HTML의 놀라운 효율성 완벽 가이드 (0) | 2026.05.10 |
| 확률적 엔지니어링과 24/7 직원 — 软件开发의 새 패러다임 (0) | 2026.05.10 |
| LLM은 위임할 때 문서를 훼손한다 — DELEGATE-52 연구로 본 경고 (0) | 2026.05.10 |