CLI-Anything으로 모든 소프트웨어를 에이전트 네이티브로 만드는 방법

 

이 글은 CLI-Anything이라는 도구를 중심으로, 왜 앞으로의 소프트웨어가 인간이 아닌 AI 에이전트 중심으로 재설계되어야 하는지, 그리고 그 문제를 CLI-Anything이 어떤 방식으로 해결하는지를 설명합니다.
기존 전문 소프트웨어가 AI 에이전트에게는 왜 다루기 어려웠는지, CLI가 왜 가장 현실적인 해답이 되는지, 그리고 실제로 어떻게 하나의 명령어만으로 소프트웨어를 에이전트 네이티브 도구로 바꿀 수 있는지를 단계별로 정리합니다.

반응형

---

소프트웨어 사용자의 변화: 인간에서 에이전트로

오늘날 대부분의 소프트웨어는 인간 사용자를 전제로 설계되어 있습니다. 마우스 클릭, GUI 버튼, 시각적 피드백 중심의 구조입니다.
하지만 앞으로의 주요 사용자는 점점 AI 에이전트가 될 가능성이 커지고 있습니다. 에이전트는 추론은 잘하지만, 실제 전문 소프트웨어를 다루는 데에는 큰 한계가 있습니다.

기존 접근 방식의 문제는 명확합니다.

• UI 자동화는 불안정하고 유지보수가 어렵습니다.
• 제공되는 API는 기능이 제한적입니다.
• 소프트웨어를 다시 만들거나 단순화하면 핵심 기능의 대부분을 잃게 됩니다.

CLI-Anything은 이 간극을 정면으로 해결하려는 시도입니다.

---

왜 CLI가 에이전트 인터페이스의 해답인가

CLI-Anything은 “왜 CLI인가?”라는 질문에서 출발합니다. 그 이유는 명확합니다.

CLI는 인간과 AI 모두에게 가장 보편적인 인터페이스입니다.

• 구조적이고 조합 가능한 텍스트 명령은 LLM의 입력 형식과 자연스럽게 맞아떨어집니다.
• 가볍고 범용적이라 운영체제나 환경에 대한 제약이 거의 없습니다.
• --help 옵션만으로도 기능을 스스로 탐색할 수 있어 자기 설명적입니다.
• JSON 출력 지원으로 에이전트가 결과를 안정적으로 처리할 수 있습니다.
• 동일한 입력은 동일한 결과를 보장해 결정론적 실행이 가능합니다.

이미 Claude Code는 수천 개의 실제 워크플로우를 CLI 기반으로 실행하고 있으며, 이는 실험이 아닌 검증된 방식임을 보여줍니다.

---

CLI-Anything이 해결하려는 핵심 문제

AI 에이전트는 사고는 잘하지만, 실제 소프트웨어를 “사용”하지 못합니다.
CLI-Anything의 핵심 목표는 단순합니다.

전문 소프트웨어의 모든 기능을 유지한 채, 에이전트가 직접 제어할 수 있도록 만드는 것

이를 위해 GUI를 대체하거나 기능을 축소하지 않습니다.
대신 실제 소프트웨어에 연결되는 완전한 CLI 인터페이스를 자동으로 생성합니다.

---

CLI-Anything의 작동 방식: 한 번의 명령어, 7단계 파이프라인

CLI-Anything은 단 하나의 명령어로 전체 과정을 수행합니다.

1. Analyze
   소스 코드를 스캔해 GUI 동작과 내부 API를 분석합니다.
2. Design
   명령 그룹, 상태 모델, 출력 형식을 설계합니다.
3. Implement
   Click 기반 CLI를 생성하고, REPL 모드와 JSON 출력을 구현합니다.
4. Plan Tests
   단위 테스트와 E2E 테스트 계획을 문서로 생성합니다.
5. Write Tests
   실제 테스트 코드를 자동으로 작성합니다.
6. Document
   테스트 결과를 문서에 반영합니다.
7. Publish
   설치 가능한 패키지로 만들어 PATH에 등록합니다.

이 과정은 데모가 아닌 실제 프로덕션 수준의 CLI를 생성합니다.

---

간단한 사용 방법 예시

플러그인 설치

Claude Code 환경에서 마켓플레이스를 추가하고 플러그인을 설치합니다.

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

CLI 생성

로컬 소스나 GitHub 저장소를 대상으로 CLI를 생성합니다.

/cli-anything ./gimp

생성된 CLI 사용

설치 후 어디서든 CLI를 사용할 수 있습니다.

cli-anything-gimp --help
cli-anything-gimp project new --width 1920 --height 1080 -o poster.json

JSON 모드를 사용하면 에이전트가 바로 이해할 수 있는 구조화된 결과를 얻을 수 있습니다.

---

다양한 도메인에서의 활용 가능성

CLI-Anything은 특정 분야에 한정되지 않습니다.
이미 다음과 같은 영역에서 적용이 검증되었습니다.

• 개발 도구 및 DevOps
• 데이터 분석과 시각화
• 크리에이티브 툴(이미지, 영상, 오디오)
• 과학·연구용 소프트웨어
• 오피스 및 엔터프라이즈 애플리케이션

총 9개의 복잡한 오픈소스 애플리케이션에서 1,436개 테스트 100% 통과라는 결과는 안정성을 보여주는 중요한 지표입니다.

---

CLI-Anything의 설계 원칙

CLI-Anything은 몇 가지 원칙을 절대 타협하지 않습니다.

• 실제 소프트웨어를 사용하며, 대체 구현은 하지 않습니다.
• REPL과 명령어 기반 인터페이스를 동시에 제공합니다.
• 모든 CLI는 동일한 사용자 경험을 유지합니다.
• 인간과 에이전트 모두를 위한 출력 방식을 제공합니다.
• 백엔드 소프트웨어가 없으면 테스트는 실패합니다.

이는 “에이전트 친화적이지만 진짜 소프트웨어는 아닌 도구”가 되지 않기 위한 선택입니다.

---

728x90

CLI-Anything은 단순한 CLI 생성 도구가 아닙니다.
이는 인간 중심으로 설계된 소프트웨어를, 에이전트 중심의 미래로 연결하는 표준화된 방법론입니다.

앞으로 AI 에이전트가 실제 업무를 수행하려면, 추론 능력만으로는 부족합니다.
실제 도구를 안정적으로 사용할 수 있어야 합니다.

CLI-Anything은 그 출발점을 제시합니다.
하나의 명령어로, 기존 소프트웨어를 그대로 유지한 채, 에이전트 네이티브 도구로 전환하는 방법.
이 접근 방식은 향후 소프트웨어 설계와 자동화의 방향을 다시 정의할 가능성이 큽니다.

300x250

https://github.com/HKUDS/CLI-Anything

GitHub - HKUDS/CLI-Anything: CLI-Anything: Making ALL Software Agent-Native