본문으로 건너뛰기
JournalTORIS / FIELD NOTES

← 블로그개발 도구

CLI-Anything(HKUDS/CLI-Anything) — 모든 소프트웨어를 AI 에이전트용 CLI로 바꾸는 7단계 오픈소스 하네스

GitHub Trending 60.8k 스타를 기록한 CLI-Anything의 7단계 하네스 생성 파이프라인과 CLI-Hub 활용법, 실무 도입 기준을 정리합니다.

Read in English

CLI-Anything(HKUDS/CLI-Anything) — 모든 소프트웨어를 AI 에이전트용 CLI로 바꾸는 7단계 오픈소스 하네스

Q. GUI 중심 데스크톱 앱이나 사내 도구를 AI 코딩 에이전트가 안정적으로 조종하려면 어떻게 해야 하나요? HKUDS/CLI-Anything을 사용하면 기존 소프트웨어의 소스 코드를 분석해 --json 출력과 상태 기반 REPL, 그리고 에이전트가 바로 읽을 수 있는 SKILL.md까지 갖춘 전용 CLI 하네스를 자동으로 생성할 수 있습니다. 스크린샷 클릭(RPA)이나 부실한 래퍼 대신 실제 프로그램의 렌더링·변환 백엔드를 그대로 호출하는 것이 핵심입니다.

⚠️ 정확도 가드레일: 이 글은 2026년 11월 20일 기준 HKUDS/CLI-Anything 공식 GitHub 저장소(v0.4.0, Star 60.8k, Fork 5.5k)와 clianything.cc 공식 문서를 직접 확인해 작성했습니다. 저장소 스타 수와 지원 소프트웨어 목록은 지속적으로 업데이트되며, 실제 프로덕션 하네스 생성 품질은 사용하는 프런티어 모델과 대상 소프트웨어의 소스 코드 공개 여부에 따라 달라집니다.

30초 요약

  • 왜 떴나: 2026년 11월 20일 기준 GitHub Trending 최상위권(3위, 누적 60.8k Stars)에 오른 오픈소스 프로젝트로, AI 에이전트가 Blender·GIMP·LibreOffice·FreeCAD·Obsidian 등 실제 소프트웨어를 CLI로 제어하게 만듭니다.
  • 두 가지 사용 경로: 이미 만들어진 도구를 바로 쓰는 cli-anything-hub(pip install cli-anything-hub)와, 내 코드베이스용 CLI를 새로 짜는 7단계 생성 파이프라인(/cli-anything)을 모두 제공합니다.
  • 기술적 차별점: UI 자동화처럼 화면을 캡처해 클릭하지 않고, 대상 앱의 실제 프로젝트 포맷(ODF, SVG, MLT XML 등)과 백엔드 바이너리를 직접 호출하며 --json 구조화 출력을 지원합니다.
  • 에이전트 호환성: Claude Code, Cursor, Codex, OpenClaw, Pi, OpenCode 등 주요 코딩 에이전트를 지원하며, 생성 시 SKILL.md를 자동 추출해 에이전트가 스스로 도구를 발견하고 호출할 수 있습니다.

기존 GUI 에이전트의 한계와 CLI-Anything의 해법

AI 에이전트가 브라우저나 데스크톱 앱을 다룰 때 가장 흔히 부딪히는 벽은 취약한 UI 자동화입니다. 화면 해상도가 바뀌거나 버튼 위치가 조금만 달라져도 좌표 기반 클릭은 쉽게 깨지고, 매 단계 스크린샷을 모델에 넘기면 토큰 비용과 지연 시간이 급증합니다. 반대로 에이전트 전용으로 기능을 대폭 축소한 간이 래퍼를 만들면 정작 실무에 필요한 고급 기능이 빠지게 됩니다.

HKUDS/CLI-Anything GitHub 저장소 화면

CLI-Anything은 이 문제를 정반대 방향에서 풉니다. 사람에게는 그래픽 인터페이스(GUI)가 편하지만, 텍스트 입출력과 파이프라인 조합에 최적화된 AI 에이전트에게는 **CLI(Command Line Interface)**가 가장 정확하고 결정론적인 인터페이스라는 점에 착안했습니다.

구분 기존 GUI/스크린샷 에이전트 CLI-Anything 하네스 방식
제어 방식 화면 캡처 후 좌표·DOM 클릭 구조화된 서브커맨드 및 상태 기반 REPL
출력 형태 시각적 결과 재해석 필요 --json 표준 출력으로 즉시 파싱
실제 작업 처리 UI 응답 대기에 종속 실제 백엔드(blender --background, libreoffice 등) 호출
에이전트 탐색 별도 프롬프트·매뉴얼 필요 --help 및 자동 생성된 SKILL.md로 즉시 파악
회귀 검증 UI 변경 시 테스트 파손 잦음 단위 + 실제 백엔드 E2E + CLI 서브프로세스 검증

광고

7단계 하네스 생성 파이프라인과 설계 원칙

새로운 소프트웨어나 사내 도구를 에이전트용으로 바꾸고 싶을 때는 /cli-anything <경로 또는 GitHub URL> 명령 한 줄로 7단계 파이프라인(HARNESS.md 표준)을 실행합니다.

  1. Analyze (분석): 대상 소스 코드를 스캔해 GUI 액션과 내부 API·데이터 모델을 매핑합니다.
  2. Design (설계): 일관된 명령 그룹과 상태 모델(Undo/Redo 포함), JSON 출력 스키마를 설계합니다.
  3. Implement (구현): Python click 기반 CLI와 공통 REPL 인터페이스(repl_skin.py), --json 모드를 구현합니다.
  4. Plan Tests (테스트 설계): 단위 테스트와 실제 파일·렌더링 결과를 검증하는 TEST.md 계획을 세웁니다.
  5. Write Tests (테스트 작성): 합성 데이터 단위 테스트뿐 아니라 실제 백엔드를 호출해 매직 바이트(%PDF- 등)와 출력물을 검증하는 E2E 테스트를 작성합니다.
  6. Document (문서화): TEST.md 결과를 반영하고, skill_generator.py로 Click 데코레이터에서 메타데이터를 추출해 skills/cli-anything-<앱>/SKILL.md를 자동 생성합니다.
  7. Publish (배포): setup.py를 구성해 pip install -e .로 즉시 PATH에 등록합니다.

실사 개발자 데스크에서 JSON CLI와 3D CAD·그래픽 도구를 함께 다루는 환경

공식 저장소 기준 이 방식으로 구축된 30여 개 이상의 하네스(GIMP, Blender, Inkscape, Audacity, LibreOffice, Draw.io, FreeCAD, Kdenlive, Obsidian, n8n 등)는 총 2,464개 테스트에서 100% 통과율을 기록하고 있습니다. 특히 "백엔드가 없으면 테스트를 건너뛰지 않고 실패 처리한다"는 원칙 덕분에 가짜 목업(Mock)이 아닌 실제 렌더링 동작이 보장됩니다.

Q. 한 번 생성하면 모든 기능이 완벽하게 들어가나요? 그렇지 않습니다. 복잡한 소프트웨어는 첫 /cli-anything 실행만으로 모든 세부 필터나 옵션을 다 덮지 못할 수 있습니다. 공식 문서에서도 /cli-anything:refine <경로> "원하는 기능" 명령으로 부족한 영역을 반복 보완하도록 권장하고 있습니다.

CLI-Hub로 바로 설치해 쓰는 방법

직접 하네스를 만들지 않고 이미 검증된 CLI를 바로 쓰고 싶다면 중앙 레지스트리인 CLI-Hub(clianything.cc)를 쓰면 됩니다. 개인 개발자용 패키지 매니저 설치와 AI 에이전트용 메타 스킬 연결 두 가지로 나뉩니다.

AI 코딩 에이전트가 CLI-Hub와 JSON CLI 레이어를 거쳐 데스크톱 앱을 제어하는 구조

개발자 터미널에서 직접 설치해 테스트할 때는 아래 순서대로 진행합니다.

pip install cli-anything-hub
cli-hub list
cli-hub search image
cli-hub install gimp
cli-hub launch gimp

코딩 에이전트가 작업 중 필요한 도구를 스스로 찾아 설치하게 하려면 npx skills 한 줄로 메타 스킬을 심어 두면 됩니다.

npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y

에이전트 프롬프트에 "CLI-Hub에서 작업에 맞는 CLI를 찾아 완료해줘"라고 지시하면 에이전트가 레지스트리를 조회해 해당 앱의 SKILL.md를 읽고 --json 플래그로 작업을 이어갑니다. 단, cli-anything-blender나 cli-anything-libreoffice처럼 실제 백엔드를 호출하는 도구는 로컬 환경에 원본 프로그램이 함께 설치되어 있어야 정상 작동합니다.

이런 에이전트 제어 흐름은 T3 Code로 코딩 에이전트를 원격 제어하는 방법이나 토리스 스튜디오의 서비스 개발 프로세스처럼 작업 단위를 쪼개고 결과를 검증하는 구조와도 맞닿아 있습니다.

도입 전 반드시 확인할 현실적 제약

공식 README의 Limitations 항목은 도입 전 체크해야 할 세 가지 조건을 명확히 짚고 있습니다.

  • 소스 코드 접근성: 7단계 생성기는 소스 코드를 분석해 CLI를 만듭니다. 소스가 비공개이고 컴파일된 바이너리만 있는 상용 앱은 생성 품질과 커버리지가 크게 떨어집니다(이런 경우 ArcGIS Pro 사례처럼 공식 SDK나 MCP 브리지를 감싸는 별도 접근이 필요합니다).
  • 프런티어 모델 의존도: 7단계 분석·설계·테스트 코드를 안정적으로 뽑아내려면 고성능 모델이 필요합니다. 작은 모델에서는 불완전한 래퍼가 나와 수동 보정이 늘어납니다.
  • 반복 개선 필요성: 1차 생성 후에는 refine 단계로 엣지 케이스와 필터 매핑을 다듬는 과정이 실무 투입의 관건입니다.

토리스의 판단

1인 개발자나 소규모 팀이 SaaS나 내부 자동화 파이프라인을 만들 때, 기존에는 "API가 없는 데스크톱 앱은 포기하거나 불안정한 RPA를 붙인다"는 선택지밖에 없었습니다. CLI-Anything은 오픈소스 앱이나 사내 도구의 백엔드를 그대로 살린 채 에이전트가 가장 잘 다루는 --json CLI와 SKILL.md 계층을 씌워 준다는 점에서 실무 가치가 높습니다.

  • 바로 써볼 만한 경우: 문서 일괄 변환(LibreOffice), 3D/다이어그램 생성(Blender, Draw.io), 로컬 지식베이스 자동화(Obsidian, Zotero)를 코딩 에이전트 워크플로우에 붙이고 싶을 때 cli-anything-hub로 검증된 하네스를 먼저 도입해 보세요.
  • 직접 생성을 추천하는 경우: 자체 CLI가 없는 사내 Python/TypeScript 프로젝트나 오픈소스 도구를 Claude Code·Cursor 에이전트에게 넘겨 반복 작업을 자동화해야 할 때 적합합니다.
  • 피해야 할 경우: 소스 코드도 공식 SDK도 없는 폐쇄형 GUI 상용 프로그램에 무작정 적용하려는 경우에는 기대만큼의 완성도가 나오지 않으므로 브라우저 자동화나 공식 API 연동을 검토하는 편이 안전합니다.

함께 보면 좋은 리소스

출처

광고

YOUTUBE · TORIS STUDIO

토리스 영상 더 보기