CLI-Anything — 소프트웨어를 에이전트가 다룰 수 있는 CLI로 변환합니다

AI 요약

CLI-Anything은 GUI 자동화 대신 표준 명령줄 인터페이스를 통해 AI 에이전트가 전문 소프트웨어를 조작하도록 돕는 오픈소스 프로젝트입니다. 기존 애플리케이션을 단순한 대체 구현으로 다시 만드는 대신, 프로젝트 파일을 생성하고 실제 프로그램의 백엔드를 호출하는 CLI 하네스(harness)를 만듭니다. GIMP, Blender, LibreOffice, QGIS, Godot 등 여러 도구를 대상으로 하며, 생성한 CLI는 에이전트뿐 아니라 일반 스크립트와 사용자도 사용할 수 있습니다.

두 가지 사용 경로

이미 등록된 도구를 쓰려면 Python 패키지 cli-anything-hub를 설치한 뒤 cli-hub list, search, info, install, update, uninstall, launch 명령으로 검색하고 관리합니다. 에이전트가 직접 도구를 찾고 설치하도록 CLI-Hub 메타 스킬도 제공합니다. 일부 CLI는 GIMP나 Blender처럼 실제 대상 프로그램을 별도로 설치해야 합니다.

등록되지 않은 소프트웨어에는 CLI-Anything 생성기를 적용합니다. 대상 코드나 저장소를 지정하면 분석, 설계, 구현, 테스트 계획, 테스트 작성, 문서화, 패키지 생성으로 이어지는 7단계 작업을 수행합니다. 기본 인터페이스는 Python Click 기반이며, 명령 하위 그룹과 REPL을 만들고 --json으로 구조화된 결과를 출력합니다. 생성 뒤에는 refine 명령으로 기능 누락을 분석해 범위를 넓히고, test와 validate로 검증할 수 있습니다. Claude Code 플러그인에서 출발했으며 Cursor, Codex, OpenCode, OpenClaw 등 여러 에이전트 환경에 설치 경로를 제공합니다.

실제 프로그램을 호출하고 결과를 검증합니다

프로젝트가 강조하는 원칙은 새 CLI가 원래 소프트웨어의 기능을 흉내 내는 데 그치지 않아야 한다는 점입니다. 예를 들어 LibreOffice 하네스는 문서 구조를 만들고 실제 LibreOffice의 헤드리스 모드로 PDF를 내보냅니다. Blender 하네스는 Blender 백엔드로 장면을 렌더링합니다. GUI 앱의 프로젝트 파일만 편집하고 다른 도구로 대충 출력하면 렌더링 단계의 효과나 기능이 빠질 수 있으므로, 대상 프로그램의 네이티브 렌더러나 적절한 변환 절차를 사용하도록 방법론 문서 HARNESS.md에 지침을 둡니다.

검증은 단위 테스트, 생성 파일을 확인하는 종단 간 테스트, 실제 소프트웨어를 실행하는 테스트, 설치한 CLI의 하위 프로세스 테스트로 나눕니다. 종료 코드가 0이라는 사실만으로 성공을 판정하지 않고, PDF 매직 바이트나 OOXML 구조, 이미지 픽셀, 오디오 신호 크기, 출력 길이 등을 검사합니다. README는 테스트 현황으로 2,461개 테스트의 통과를 제시합니다. 다만 모든 하네스가 같은 방식으로 실제 백엔드 테스트를 수행하는 것은 아니며, 일부 테스트는 백엔드가 있을 때만 실행됩니다.

설치와 배포

각 하네스는 cli_anything.<software> 네임스페이스를 사용하는 Python 패키지로 구성하고, pip install -e .로 설치해 PATH에서 실행합니다. 대화형 REPL과 일반 하위 명령을 함께 지원하며, --help와 각 도구의 SKILL.md를 통해 에이전트가 사용 가능한 명령과 작업 지침을 찾도록 합니다. 저장소 루트의 스킬 파일은 npx skills로 검색·설치할 수 있고, 설치된 패키지에는 호환용 사본도 포함합니다. CLI-Hub는 자체 하네스뿐 아니라 pip, npm, Homebrew, 시스템 도구 등 여러 설치 방식의 공개 CLI도 다룹니다.

적용 범위와 한계

README에는 창작, 오피스, 데이터 처리, 개발, GIS, 게임, 로컬 LLM 등 다양한 범주의 하네스가 소개됩니다. 새 하네스를 자동 생성하는 기능은 대상 소프트웨어의 코드나 API에 접근할 수 있어야 제대로 작동합니다. 프로젝트는 프론티어급 모델을 전제로 하며, 작은 모델에서는 생성 결과를 상당히 수정해야 할 수 있다고 밝힙니다. 바이너리만 제공되어 소스 분석이 어려운 프로그램은 품질과 기능 범위가 떨어질 수 있고, 한 번의 생성으로 전체 기능을 덮지 못하면 refine을 반복해야 합니다. 이 방식은 에이전트 도구를 명령으로 표준화하지만, 실제 백엔드 설치와 애플리케이션별 검증 부담까지 없애지는 않습니다.

원문: GitHub / 번역·요약: Trawling