CLI-Anything: GUI 소프트웨어를 AI 에이전트용 CLI로 자동 변환하는 오픈소스 도구
CLI-Anything: GUI 소프트웨어를 AI 에이전트용 CLI로 자동 변환하는 오픈소스 도구
AI 에이전트가 전문 소프트웨어를 직접 조작하는 시대가 열리고 있습니다. 그런데 GIMP로 이미지를 편집하거나 Blender로 3D 모델링을 하려면, 에이전트에게 소프트웨어를 "쓸 수 있는 손"을 줘야 합니다. CLI-Anything은 GUI 기반 소프트웨어의 코드베이스를 분석하여 AI 에이전트 전용 CLI를 자동으로 생성하는 오픈소스 도구입니다.
CLI-Anything은 소프트웨어의 소스코드를 분석하여 7단계 자동 파이프라인으로 AI 에이전트용 CLI를 생성하는 홍콩대학교(HKU) HKUDS 연구팀의 오픈소스 프로젝트입니다.
AI 에이전트가 소프트웨어를 쓰는 기존 방법의 한계
오늘날 AI 에이전트가 전문 소프트웨어를 사용하는 방법은 크게 세 가지입니다. 첫째, Computer Use 같은 GUI 에이전트가 스크린샷을 찍고 마우스를 시뮬레이션하는 방식입니다. 직관적이지만 느리고 불안정합니다. 둘째, MCP(Model Context Protocol) 서버를 통해 소프트웨어별 전용 프로토콜을 개발하는 방법인데, 각 소프트웨어마다 별도 구현이 필요합니다. 셋째, 전용 API 래퍼를 수동으로 구현하는 것으로, 확장성이 부족합니다.
CLI-Anything은 이 세 가지 접근의 단점을 한 번에 해결합니다. 비유하자면, GUI 에이전트가 "로봇이 마우스를 잡고 화면을 보면서 클릭하는 것"이라면, CLI-Anything은 "로봇에게 전용 리모컨을 만들어주는 것"입니다.
CLI가 AI 에이전트에게 최적인 이유
CLI가 AI 에이전트에게 적합한 이유는 구조적입니다. CLI는 구조화된 텍스트 입출력을 사용하므로 LLM의 형식과 정확히 일치합니다. --help 플래그 하나면 에이전트가 도구를 자동으로 발견할 수 있고, --json 출력은 파싱 복잡성을 완전히 제거합니다.
결과가 결정론적이라는 점도 중요합니다. 같은 명령을 같은 인자로 실행하면 같은 결과가 나옵니다. GUI 에이전트처럼 "이번에는 버튼 위치가 바뀌어서 클릭을 못 했다"는 일이 발생하지 않습니다.
Google Workspace CLI 개발자 Justin Poehnelt는 "CLI의 1차 소비자가 더 이상 사람이 아니라 AI 에이전트"라고 말했습니다. 2026년 초부터 기술 커뮤니티에서 진행 중인 "CLI vs MCP" 논쟁의 핵심이기도 합니다.
CLI-Anything의 7단계 자동 파이프라인
CLI-Anything의 핵심은 소스코드를 투입하면 완전한 CLI가 나오는 7단계 자동 파이프라인입니다.
- 분석(Analyze): 소스코드를 스캔하고 GUI 동작을 API에 매핑합니다
- 설계(Design): 명령어 그룹, 상태 모델, 출력 형식을 설계합니다
- 구현(Implement): Click CLI 프레임워크 기반으로 REPL 모드, JSON 출력, Undo/Redo를 구현합니다
- 테스트 계획(Plan Tests): TEST.md에 단위 테스트와 E2E 테스트 계획을 생성합니다
- 테스트 작성(Write Tests): 포괄적 테스트 스위트를 구현합니다
- 문서화(Document): 결과를 문서화합니다
- 배포(Publish): setup.py를 생성하고 PATH에 설치합니다
주목할 점은 "Authentic Software Integration" 원칙입니다. CLI-Anything은 실제 소프트웨어의 백엔드를 직접 호출합니다. 대체 구현이나 모의 구현이 아닌, 원본 소프트웨어의 기능을 100% 그대로 사용합니다.
검증된 9개 소프트웨어와 1,436개 테스트
CLI-Anything은 이미 9개의 대표 소프트웨어에서 검증되었습니다.
| 소프트웨어 | 도메인 | CLI 명령 | 테스트 수 |
|---|---|---|---|
| GIMP | 이미지 편집 | cli-anything-gimp | 107개 |
| Blender | 3D 모델링/렌더링 | cli-anything-blender | 208개 |
| Inkscape | 벡터 그래픽 | cli-anything-inkscape | 202개 |
| Audacity | 오디오 제작 | cli-anything-audacity | 161개 |
| LibreOffice | 오피스 문서 | cli-anything-libreoffice | 158개 |
| OBS Studio | 라이브 스트리밍 | cli-anything-obs-studio | 153개 |
| Kdenlive | 비디오 편집 | cli-anything-kdenlive | 155개 |
| Shotcut | 비디오 편집 | cli-anything-shotcut | 154개 |
| Draw.io | 다이어그램 | cli-anything-drawio | 138개 |
총 1,436개 테스트를 100% 통과했습니다. 이미지 편집부터 3D 모델링, 오디오 제작, 비디오 편집, 문서 처리까지 다양한 도메인을 커버합니다.
CLI-Anything vs MCP vs Computer Use 비교
AI 에이전트 도구 연동 방식을 비교하면 CLI-Anything의 포지셔닝이 명확해집니다.
| 비교 항목 | CLI-Anything | MCP 서버 | Computer Use |
|---|---|---|---|
| 설정 방식 | 소스코드 → CLI 자동 생성 | 소프트웨어별 전용 프로토콜 개발 | 설정 불필요(스크린샷+클릭) |
| 속도 | 빠름(구조화된 명령) | 보통(프로토콜 통신) | 느림(화면 인식+시뮬레이션) |
| 안정성 | 높음(결정론적) | 높음 | 낮음(UI 변경에 취약) |
| 범용성 | 소스코드 있는 소프트웨어 | 소프트웨어별 개발 필요 | 화면 있으면 가능 |
| 토큰 효율 | ~200 토큰/호출 | ~300 토큰/호출(스키마 주입) | ~1,000+ 토큰/호출(스크린샷) |
| 확장성 | 높음(자동화) | 낮음(수동 개발) | 높음(범용) |
토큰 효율에서 CLI가 MCP 대비 약 33% 우위를 보이는 것은 실무적으로 중요합니다. 대규모 에이전트 워크플로우에서는 이 차이가 비용에 직접 영향을 미칩니다.
설치 및 사용법
CLI-Anything은 Claude Code 플러그인으로 가장 쉽게 설치할 수 있습니다.
# Claude Code 플러그인 설치
/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
# GIMP용 CLI 생성
/cli-anything ./gimp
수동 설치도 가능합니다.
git clone https://github.com/HKUDS/CLI-Anything.git
cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything
/reload-plugins
생성된 CLI의 사용 예시를 보면 직관적입니다.
# GIMP: 새 프로젝트 생성
cli-anything-gimp project new --width 1920 --height 1080 -o poster.json
# GIMP: 레이어 추가 (JSON 출력)
cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e"
# GIMP: REPL 모드 진입
cli-anything-gimp
# LibreOffice: 문서 생성 → 제목 추가 → PDF 내보내기
cli-anything-libreoffice document new -o report.json --type writer
cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report" --level 1
cli-anything-libreoffice --project report.json export render output.pdf -p pdf
ReplSkin 기능으로 모든 생성된 CLI에 일관된 대화형 REPL 인터페이스를 제공하며, Undo/Redo도 지원합니다.
개발팀: HKUDS의 트랙 레코드
CLI-Anything을 만든 HKUDS(Data Intelligence Lab)는 홍콩대학교(HKU)의 연구실입니다. 단순 학술 연구실이 아닌, 실무에 바로 적용 가능한 오픈소스를 지속적으로 내놓는 팀입니다.
- 디렉터: Chao Huang 교수 (Google Scholar 인용 11,000+, h-index 55)
- 연구실 GitHub Stars: 77,000+ (글로벌 Top-200)
- 대표 프로젝트: LightRAG(29K+ Stars), RAG-Anything, DeepCode, AutoAgent
CLI-Anything의 주요 기여자인 Yuhao Yang은 "사람들이 가장 어려운 작업을 OpenClaw에 던지면, Claw들은 Claude Code를 호출한다. CLI를 완벽하게 구현했기 때문"이라고 설명합니다.
로드맵과 향후 전망
CLI-Anything 팀이 공개한 향후 계획은 다음과 같습니다.
- 더 많은 애플리케이션 카테고리 지원 (CAD, DAW, IDE, EDA, 과학 도구)
- 에이전트 작업 완료율 벤치마크 스위트
- 커뮤니티 기여 CLI 하네스
- Claude Code 외 추가 에이전트 프레임워크 연동
- 비공개 소프트웨어/웹 서비스 API 패키징 지원
- SKILL.md 생성 (에이전트 스킬 발견/오케스트레이션)
특히 SKILL.md 생성은 에이전트가 도구를 스스로 발견하고 조합하는 미래를 의미합니다. CLI-Anything으로 생성된 CLI들이 에이전트 생태계에서 하나의 "스킬"로 인식되는 것입니다.
FAQ (자주 묻는 질문)
Q: CLI-Anything으로 생성한 CLI는 상업적으로 사용할 수 있나요? MIT 라이선스이므로 상업적 사용이 가능합니다. 다만 대상 소프트웨어 자체의 라이선스는 별도로 확인해야 합니다.
Q: 소스코드가 없는 상용 소프트웨어에도 사용할 수 있나요? 현재는 소스코드가 있는 오픈소스 소프트웨어를 대상으로 합니다. 로드맵에 비공개 소프트웨어/웹 서비스 API 패키징 지원이 포함되어 있습니다.
Q: MCP 서버가 이미 있는 소프트웨어라면 CLI-Anything을 써야 하나요? MCP 서버가 잘 구축되어 있다면 그대로 사용해도 됩니다. CLI-Anything은 MCP 서버가 없거나, 토큰 효율이 중요하거나, 여러 소프트웨어를 동일한 방식으로 통합하고 싶을 때 유리합니다.
Q: 어떤 에이전트 프레임워크와 호환되나요? Claude Code, OpenClaw, nanobot, Cursor 등 CLI 호출이 가능한 모든 에이전트 프레임워크와 호환됩니다.
마무리
CLI-Anything은 "Making ALL Software Agent-Native"라는 슬로건처럼, 모든 소프트웨어를 AI 에이전트가 자연스럽게 사용할 수 있는 세상을 목표로 합니다. GUI 시대가 끝나는 것은 아니지만, AI 에이전트에게는 CLI가 모국어입니다. 2주 만에 2,100+ Stars를 받은 것은 개발자 커뮤니티가 이 필요성에 공감하고 있다는 증거입니다.
AI 에이전트를 활용한 자동화를 고려하고 있다면, CLI-Anything은 검토해볼 가치가 있는 도구입니다.
참고 자료
- CLI-Anything 공식 GitHub - 소스코드, 설치 가이드, 예제
- Chao Huang 교수 공식 발표 - 프로젝트 소개 및 비전
- Yuhao Yang 공식 소개 - 핵심 기여자의 기술 설명
- HKUDS 연구실 - 연구팀 프로필 및 프로젝트
- CLI is the New MCP - CLI vs MCP 논쟁 배경
- Why CLI Tools Are Beating MCP for AI Agents - CLI 장점 상세 분석
