목차
CLI-Anything은 GIMP, Blender, LibreOffice 등 기존 소프트웨어에 AI 에이전트가 직접 제어할 수 있는 CLI 래퍼(harness)를 자동으로 생성해주는 오픈소스 프레임워크다. “오늘의 소프트웨어는 사람이 쓰지만, 내일의 사용자는 에이전트”라는 철학 아래, AI 에이전트와 세상의 모든 소프트웨어 사이의 간극을 메우는 것을 목표로 한다. GitHub ★35.9K, 2,269개 이상의 테스트를 통과하고 있으며 Apache 2.0 라이선스로 공개되어 있다.
왜 CLI인가
GUI는 AI 에이전트가 다루기 어렵지만, CLI는 에이전트가 다루기에 이상적인 인터페이스다.
- 구조적·조합 가능 — 텍스트 명령이 LLM 형식과 잘 맞고, 복잡한 워크플로우로 연결 가능
- 경량·범용 — 최소 오버헤드로 모든 시스템에서 작동
- 자기 설명적 —
--help플래그가 에이전트가 탐색할 수 있는 자동 문서 제공 - 에이전트 우선 설계 — 구조화된 JSON 출력으로 파싱 복잡성 제거
- 결정론적 — 일관된 결과로 예측 가능한 에이전트 동작 보장
핵심 기능
7단계 자동 생성 파이프라인
/cli-anything ./소프트웨어-경로 한 줄로 완전한 CLI를 자동 생성한다.
- 분석 — 소스 코드 스캔, GUI 동작을 API로 매핑
- 설계 — 커맨드 그룹, 상태 모델, 출력 형식 아키텍처
- 구현 — Click 기반 CLI (REPL, JSON 출력, undo/redo 포함)
- 테스트 계획 — 단위 + E2E 테스트 플랜 (TEST.md)
- 테스트 작성 — 포괄적 테스트 스위트 구현
- SKILL.md 생성 — AI 에이전트가 탐색 가능한 스킬 정의 파일 자동 생성
- 검증 — 전체 파이프라인 통합 검증
CLI-Hub 패키지 매니저
커뮤니티가 만든 모든 CLI 하네스를 하나의 명령으로 설치할 수 있는 중앙 레지스트리.
pip install cli-anything-hub
cli-hub install <name> # CLI 하네스 설치
cli-hub search <keyword> # 레지스트리 검색Obsidian, Zotero, QGIS, FreeCAD, n8n, Godot, Blender, GIMP 등 수십 개의 하네스가 이미 등록되어 있다.
설치 및 사용법
Claude Code에서 사용
# CLI-Anything 마켓플레이스 추가
/plugin marketplace add HKUDS/CLI-Anything
# 플러그인 설치
/plugin install cli-anything
# 소프트웨어용 CLI 생성
/cli-anything ./my-software다른 AI 에이전트에서 사용
Claude Code 외에도 Pi, OpenClaw, Codex, OpenCode, GitHub Copilot CLI 등을 지원한다.
# SKILL.md 기반 스킬 설치 (에이전트 공통)
npx skills add HKUDS/CLI-Anything --skill <skill-name> -g -y지원 소프트웨어 (주요 예시)
| 카테고리 | 소프트웨어 |
|---|---|
| 이미지·디자인 | GIMP, Blender, Inkscape, Krita |
| 오피스·문서 | LibreOffice, Obsidian, Zotero |
| GIS·3D | QGIS, FreeCAD, RenderDoc |
| 게임·미디어 | Godot, Slay the Spire II, MuseScore |
| 개발·자동화 | n8n, WireMock, Exa |
| 브라우저 | Safari, CLIBrowser |
누가, 언제 쓰면 좋은가
- 에이전트 워크플로우 구축자 — 에이전트가 GUI 소프트웨어를 직접 제어해야 할 때
- 소프트웨어 개발자 — 자신의 앱을 AI 에이전트 네이티브로 전환하고 싶을 때
- 자동화 엔지니어 — 레거시 소프트웨어를 AI 파이프라인에 통합해야 할 때
- 연구자·교육자 — AI 에이전트와 기존 도구 연동 실험이 필요할 때
관련 문서
- GitHub: HKUDS/CLI-Anything
- CLI-Hub: hkuds.github.io/CLI-Anything
- 라이선스: Apache 2.0
- 관련 토픽: agent-skills, claude-code, openclaw, goose