CLI-Anything은 AI 에이전트가 현실 세계의 다양한 소프트웨어와 상호작용할 수 있도록 돕는 오픈소스 프로젝트입니다. 현재 소프트웨어는 주로 사람 사용자에 맞춰져 있어, AI 에이전트가 복잡한 UI 자동화나 제한적인 API를 통해 소프트웨어를 제어하는 데 어려움을 겪는 문제를 해결하고자 합니다. 이 프로젝트의 핵심 비전은 모든 소프트웨어를 'agent-native'하게 만들어, AI 에이전트가 GUI, 재구축, 복잡한 래퍼 없이도 구조화된 CLI (Command Line Interface)를 통해 어떤 애플리케이션이든 제어할 수 있도록 하는 것입니다.

CLI가 에이전트와 소프트웨어 간의 범용 인터페이스로 선택된 이유는 다음과 같습니다:

• Structured & Composable: 텍스트 명령어가 LLM(Large Language Model) 형식과 일치하며 복잡한 워크플로우를 위해 체인화될 수 있습니다.
• Lightweight & Universal: 오버헤드가 적고 시스템 간 종속성 없이 작동합니다.
• Self-Describing: --help 플래그를 통해 에이전트가 자동으로 문서를 발견할 수 있습니다.
• Agent-First Design: 구조화된 JSON 출력을 통해 파싱 복잡성을 제거합니다.
• Deterministic & Reliable: 일관된 결과를 통해 예측 가능한 에이전트 동작을 가능하게 합니다.

CLI-Anything의 핵심 방법론은 소프트웨어의 소스 코드나 레포지토리를 입력으로 받아 완전한 CLI를 자동으로 생성하는 7단계(7-phase pipeline) 프로세스입니다. 이 프로세스는 $/cli-anything:cli-anything <software-path-or-repo>$ 명령을 통해 실행됩니다:

1. Analyze (분석): 소프트웨어의 소스 코드를 스캔하고 GUI 동작을 API 호출에 매핑합니다.
2. Design (설계): 명령어 그룹, 상태 모델, 출력 형식 등을 설계합니다.
3. Implement (구현): REPL(Read-Eval-Print Loop) 기능, JSON 출력, 실행 취소/다시 실행 기능을 포함하는 Click CLI를 구축합니다.
4. Plan Tests (테스트 계획): 유닛(unit) 및 E2E(End-to-End) 테스트 계획을 담은 TEST.md 파일을 생성합니다.
5. Write Tests (테스트 작성): 포괄적인 테스트 스위트를 구현합니다.
6. Document (문서화): 테스트 결과를 포함하여 TEST.md를 업데이트합니다.
7. Publish (배포): setup.py 파일을 생성하고 CLI를 시스템 PATH에 설치하여 pip install을 통해 사용 가능하게 합니다.

생성된 CLI는 $cli-anything-<software-name>$ 형식으로 명명되며, 설치 후 REPL 모드(cli-anything-gimp) 또는 서브커맨드 인터페이스(cli-anything-gimp project new --width 1920)로 사용할 수 있습니다. refine 명령을 통해 기존 CLI의 기능 범위를 확장하거나 특정 영역에 집중하여 개선할 수 있습니다.

주요 특징은 다음과 같습니다:

• Authentic Software Integration: 실제 애플리케이션(예: Blender, LibreOffice)에 직접 호출하여 작업을 수행하며, 단순한 재구현이 아닌 실제 기능을 활용합니다.
• Production-Grade Testing: 유닛 테스트, 네이티브 E2E 테스트(파일 형식 유효성 검사), 실제 백엔드 E2E 테스트(소프트웨어 실행 및 출력 검증), CLI 서브프로세스 테스트 등 다계층 검증을 통해 견고함을 보장합니다. 총 16개 이상의 애플리케이션에 대해 1,917개 이상의 테스트를 통과했으며, 이는 100% 합격률을 보입니다.
• SKILL.md Generation: 생성된 각 CLI는 해당 Python 패키지 내부에 SKILL.md 파일을 포함합니다. 이 파일은 YAML frontmatter, 명령어 그룹, 사용 예시 등을 포함한 AI 에이전트가 CLI의 기능을 발견하고 활용할 수 있도록 돕는 self-contained 스킬 정의입니다. pip install 시 자동 설치되며, REPL 배너에 경로가 표시되어 에이전트가 쉽게 찾을 수 있습니다.
• CLI-Hub: 에이전트가 필요한 CLI를 자율적으로 발견하고 설치할 수 있도록 하는 중앙 레지스트리입니다. cli-hub-meta-skill을 통해 에이전트가 카탈로그를 탐색하고, 적합한 CLI를 pip install로 설치한 후 해당 CLI의 SKILL.md를 읽어 사용하는 완전 자율 워크플로우를 지원합니다.

CLI-Anything은 Claude Code, OpenCode, Goose, Qodercli, OpenClaw, Codex, GitHub Copilot CLI 등 다양한 AI 코딩 에이전트 플랫폼을 지원합니다. 이 프로젝트는 GitHub 레포지토리, AI/ML 플랫폼, 데이터 분석 도구, 개발 도구, 크리에이티브 및 미디어 소프트웨어, 과학 컴퓨팅, 엔터프라이즈 및 오피스 애플리케이션 등 광범위한 도메인에 걸쳐 소프트웨어를 'agent-native' 도구로 변환하는 데 사용될 수 있습니다. 프로젝트 구조는 각 agent-harness/ 디렉토리 아래에 설치 가능한 Python 패키지로 구성되어 있으며, Click CLI, 핵심 모듈, 유틸리티, 테스트 등이 포함됩니다.