CLI-Anything은 GIMP, Blender, LibreOffice 등 기존 소프트웨어에 AI 에이전트가 직접 제어할 수 있는 CLI 래퍼(harness)를 자동으로 생성해주는 오픈소스 프레임워크다. “오늘의 소프트웨어는 사람이 쓰지만, 내일의 사용자는 에이전트”라는 철학 아래, AI 에이전트와 세상의 모든 소프트웨어 사이의 간극을 메우는 것을 목표로 한다. GitHub에서 빠르게 성장 중이며, 2,202개 이상의 테스트를 통과하고 있다.

왜 CLI인가

GUI는 AI 에이전트가 다루기 어렵지만, CLI는 에이전트가 다루기에 이상적인 인터페이스다.

• 구조적·조합 가능 — 텍스트 명령이 LLM 형식과 잘 맞고, 복잡한 워크플로우로 연결 가능
• 경량·범용 — 최소 오버헤드로 모든 시스템에서 작동
• 자기 설명적 — --help 플래그가 에이전트가 탐색할 수 있는 자동 문서 제공
• 에이전트 우선 설계 — 구조화된 JSON 출력으로 파싱 복잡성 제거
• 결정론적 — 일관된 결과로 예측 가능한 에이전트 동작 보장

핵심 기능

7단계 자동 생성 파이프라인

/cli-anything ./소프트웨어-경로 한 줄로 완전한 CLI를 자동 생성한다.

1. 분석 — 소스 코드 스캔, GUI 동작을 API로 매핑
2. 설계 — 커맨드 그룹, 상태 모델, 출력 형식 아키텍처
3. 구현 — Click 기반 CLI (REPL, JSON 출력, undo/redo 포함)
4. 테스트 계획 — 단위 + E2E 테스트 플랜 (TEST.md)
5. 테스트 작성 — 포괄적 테스트 스위트 구현
6. SKILL.md 생성 — AI 에이전트가 탐색 가능한 스킬 정의 파일 자동 생성
7. 검증 — 전체 파이프라인 통합 검증

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

지원 소프트웨어 (주요 예시)

누가, 언제 쓰면 좋은가

• 에이전트 워크플로우 구축자 — 에이전트가 GUI 소프트웨어를 직접 제어해야 할 때
• 소프트웨어 개발자 — 자신의 앱을 AI 에이전트 네이티브로 전환하고 싶을 때
• 자동화 엔지니어 — 레거시 소프트웨어를 AI 파이프라인에 통합해야 할 때
• 연구자·교육자 — AI 에이전트와 기존 도구 연동 실험이 필요할 때

관련 문서

• GitHub: HKUDS/CLI-Anything
• CLI-Hub: hkuds.github.io/CLI-Anything
• 라이선스: MIT
• 관련 토픽: agent-skills, claude-code, openclaw, goose