CLI-Anything — 모든
소프트웨어를 AI의 손에

먼저, "AI가 진짜 도구를 못 쓴다"는 게 무슨 말?

에이전트가 직면한 인터페이스 절벽.

2026년 현재 AI 에이전트는 코드는 잘 쓰고 글도 잘 짓는다. 하지만 Blender로 3D 모델을 만들거나 GIMP로 포스터를 디자인하는 실제 전문 도구는 거의 못 다룬다. 이유는 단순하다 — 이 도구들은 사람이 마우스로 클릭하는 GUI로 만들어졌고, 에이전트는 키보드로 명령어를 치는 CLI밖에 못 쓰기 때문이다.

기존 해결책은 모두 한계가 있었다. RPA(스크린샷 클릭)는 해상도만 바뀌어도 깨지고, 각 앱의 공식 API는 기능의 10%만 노출하고, "AI용 GIMP-lite" 같은 재구현은 실무에 못 쓴다. CLI-Anything은 "실제 소프트웨어를 그대로 두고, 그 위에 에이전트용 CLI 껍데기만 자동으로 씌우자"는 발상으로 이 문제를 정면 돌파한다.

이 프로젝트의 핵심 메시지

한 문장으로 줄이면.

2026년 5월, 트렌딩 13위에 오른 이유

기존 한계 + 경쟁 우위 + 생태계 야심.

이유 1 — "AI가 진짜 도구를 못 쓴다"는 근본 문제 정면 돌파

기존 세 가지 해결책은 모두 부족했다. CLI-Anything의 답은 단순하다 — 흉내내지 말고 진짜를 부르자.

CLI-Anything은 Blender는 그대로 Blender를 부르고, LibreOffice는 그대로 LibreOffice를 호출한다. 기능 손실 0%, 호환성 100% — 이게 진짜 차별점이다.

이유 2 — 7단계 파이프라인으로 재현 가능한 결과

비슷한 시도(예: 단순 LLM 프롬프트 자동 생성)는 결과 품질이 들쭉날쭉했다. CLI-Anything은 7단계를 고정 SOP(Standard Operating Procedure)로 박아넣어 HARNESS.md 한 파일로 표준화했다. 18개 이상의 앱에 적용해 2,461개 테스트 100% 통과라는 검증된 메트릭이 가능해진 이유다.

이유 3 — "에이전트 시대의 운영체제"를 노리는 야심

홈페이지 슬로건이 인상적이다 — "Today's Software Serves Humans. Tomorrow's Users will be Agents." (오늘의 소프트웨어는 사람을 위한 것, 내일의 사용자는 에이전트). 별도로 CLI-Hub라는 npm/PyPI 같은 중앙 레지스트리를 운영해서 cli-hub install 한 줄로 누가 만든 CLI든 가져다 쓸 수 있게 했다. 생태계를 노리는 그림이다.

경쟁 비교

전체 기술 지도

코어 · 에이전트 통합 · 백엔드 어댑터 · 출력 포맷.

코어 (Python 생태계)

AI 에이전트 통합 계층

같은 기능을 다섯 플랫폼에 동시 배포한다. 어댑터 패턴의 모범 사례.

백엔드 어댑터 — 진짜 소프트웨어와의 연결

이게 CLI-Anything의 진짜 노하우다. 각 앱마다 다른 방식으로 진짜 프로그램을 부른다.

출력 / 통신 포맷

시스템 구조와 5가지 설계 패턴

전체 구조도 → 핵심 패턴 → 7단계 파이프라인.

시스템 구조도

┌─────────────────────────────────────────────────────────────────┐
│                  사용자 (개발자) — Claude Code 등                 │
└───────────────────────────┬─────────────────────────────────────┘
                            │ /cli-anything ./gimp
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│           CLI-Anything Plugin (HARNESS.md SOP)                   │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │  7-Phase Auto Pipeline                                    │   │
│  │  1 Analyze  → 2 Design → 3 Implement → 4 Plan Tests       │   │
│  │  5 Write Tests → 6 Document → 6.5 SKILL.md → 7 Publish    │   │
│  └──────────────────────────────────────────────────────────┘   │
└───────────────────────────┬─────────────────────────────────────┘
                            │ generates
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│         agent-harness/  (생성된 Python 패키지)                    │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐   │
│  │ Click CLI   │ │ ReplSkin    │ │ Backend Adapter         │   │
│  │ (commands)  │ │ (REPL UI)   │ │ (bpy / API / XML 조작)  │   │
│  └─────────────┘ └─────────────┘ └────────────┬────────────┘   │
│                                                │                 │
│  ┌─────────────────────────────────┐           │                 │
│  │ Tests (단위/E2E/subprocess)     │           │                 │
│  └─────────────────────────────────┘           │                 │
│  ┌─────────────────────────────────┐           │                 │
│  │ SKILL.md (에이전트 자동 발견용) │           │                 │
│  └─────────────────────────────────┘           │                 │
└─────────────────────────────────────────────────┼─────────────────┘
                                                  ▼
                              ┌──────────────────────────┐
                              │   실제 소프트웨어 백엔드   │
                              │  (Blender / GIMP / OBS…) │
                              └──────────────────────────┘

패턴 1 — Authentic Software Integration (정통 통합)

"흉내내지 않고 진짜를 부른다." LibreOffice CLI가 PDF를 만들 때 실제 LibreOffice 바이너리를 headless 모드로 호출한다. 그래서 백엔드가 없으면 테스트가 skip이 아니라 fail 된다 — 가짜 기능을 못 만들게 강제하는 설계 철학.

패턴 2 — Dual Interaction Mode (이중 인터랙션)

같은 CLI가 두 가지 모드로 동작한다.

• 인자 주면 → cli-anything-gimp layer add ... (스크립트/파이프라인용)
• 인자 없이 실행 → REPL(대화형 모드) 진입 (에이전트 세션·디버깅용)

패턴 3 — Stateful Project File (상태 외부화)

모든 작업은 프로젝트 파일(JSON)에 저장된다. --project report.json으로 같은 상태를 여러 명령이 공유. 덕분에 undo/redo, 세션 복원, 병렬 작업 모두 가능해진다.

패턴 4 — Agent-Native I/O (에이전트 우선 입출력)

--json 플래그 하나로 모든 출력을 머신 친화적 형식으로 전환. 에이전트는 --help와 which 표준 명령만으로 능력을 발견한다.

패턴 5 — Zero-Config Discoverability (자동 발견)

pip install -e .만 하면 PATH에 자동 등록되고, 각 패키지 안의 SKILL.md가 REPL 배너에 절대경로로 표시되어 에이전트가 "스킬 파일이 여기 있다"는 걸 즉시 안다.

7단계 자동 파이프라인 상세

레포 구조 해부

어디에 뭐가 있는지.

cli-anything/
├── cli-anything-plugin/         # Claude Code 플러그인 본체
│   ├── HARNESS.md               #   7단계 SOP "성경"
│   ├── repl_skin.py             #   모든 CLI가 공유하는 REPL UI
│   ├── commands/                #   슬래시 커맨드 정의
│   │   ├── cli-anything.md      #     메인 빌드 커맨드
│   │   ├── refine.md            #     점진적 개선
│   │   ├── test.md              #     테스트 실행
│   │   └── validate.md          #     표준 준수 검증
│   └── scripts/
│
├── codex-skill/                 # Codex용 어댑터
├── openclaw-skill/              # OpenClaw용 SKILL.md
├── opencode-commands/           # OpenCode 슬래시 커맨드
├── qoder-plugin/                # Qodercli 플러그인
│
├── gimp/agent-harness/          # 16개 앱 어댑터 (각각 별도)
├── blender/agent-harness/
├── inkscape/agent-harness/
├── audacity/agent-harness/
├── libreoffice/agent-harness/
├── obs-studio/agent-harness/
├── kdenlive/agent-harness/
├── shotcut/agent-harness/
├── zoom/agent-harness/
├── drawio/agent-harness/
├── mermaid/agent-harness/
├── anygen/agent-harness/
├── comfyui/agent-harness/
├── notebooklm/agent-harness/
├── adguardhome/agent-harness/
├── ollama/agent-harness/
├── mubu/agent-harness/
│
├── docs/hub/                    # CLI-Hub 정적 페이지
├── skill_generation/tests/      # SKILL.md 생성기 테스트
├── registry.json                # CLI-Hub 중앙 레지스트리
├── CONTRIBUTING.md              # 새 앱 추가 가이드
└── README.md / _CN / _JA        # 다국어 README

각 agent-harness/ 내부 표준 구조

{software}/agent-harness/
├── cli_anything/{software}/     # 실제 Python 패키지
│   ├── cli.py                   #   Click 엔트리포인트
│   ├── core/                    #   도메인 로직
│   ├── utils/
│   │   ├── repl_skin.py         #     공통 REPL (복사본)
│   │   └── backend.py           #     백엔드 어댑터 (앱별 다름)
│   ├── skills/SKILL.md          #   자동 생성된 에이전트 스킬
│   └── tests/
│       ├── test_core.py         #   단위 테스트
│       ├── test_e2e.py          #   진짜 백엔드 호출 테스트
│       └── test_cli.py          #   subprocess.run 검증
├── setup.py                     # pip 패키지 정의
├── README.md
└── TEST.md                      # 테스트 계획 + 결과

분야별 배울 것

기술 영역마다 무엇을 가져갈지.

Python Click 프레임워크

이 레포의 모든 CLI는 Click으로 작성된다. 데코레이터 기반 명령 그룹화, 자동 --help 생성, 타입 변환을 한 번에 익힐 수 있다.

import click

@click.group()
@click.option('--json', 'json_mode', is_flag=True, help='JSON 출력')
@click.pass_context
def cli(ctx, json_mode):
    ctx.obj = {'json': json_mode}

@cli.group()
def project():
    """프로젝트 명령 그룹"""

@project.command()
@click.option('--width', type=int, default=1920)
@click.option('--height', type=int, default=1080)
@click.option('-o', '--output', required=True)
def new(width, height, output):
    """새 프로젝트 생성"""
    click.echo(f"Created {width}x{height} project: {output}")

실습 아이디어: 자주 쓰는 도구 하나(가계부 엑셀, 자동 SSH 접속)를 Click 기반 CLI로 만들어보기. --json 플래그도 같이.

SKILL.md / 에이전트 스킬 시스템

Claude Code, OpenCode, Codex 등 모던 AI 에이전트는 "SKILL.md"라는 표준 파일로 능력을 발견한다. CLI-Anything은 이걸 코드 메타데이터에서 자동 추출해준다.

---
name: cli-anything-gimp
description: GIMP 이미지 편집을 위한 에이전트 CLI
---

## Commands
- `cli-anything-gimp project new` — 새 이미지 생성
- `cli-anything-gimp layer add` — 레이어 추가

## Usage
사용자가 "포스터 만들어줘" 요청 시:
1. project new --width 1920 ...
2. layer add --type text ...

실습 아이디어: 본인의 작업 흐름 하나를 SKILL.md로 작성해보고 Claude Code에 install. 호출되는지 검증.

멀티 플랫폼 플러그인 배포 (어댑터 패턴)

같은 기능을 Claude Code 플러그인, OpenCode 커맨드, OpenClaw 스킬, Codex 스킬, Qodercli 플러그인 다섯 곳에 동시 배포하는 방법을 보여준다. 각 플랫폼의 인터페이스 차이를 추상화하는 어댑터 패턴을 코드로 학습할 수 있다.

3중 테스트 전략 (Pytest)

실습 아이디어: 본인 프로젝트에 이 3중 구조 도입. 특히 "백엔드 없으면 fail" 패턴은 통합 테스트 신뢰도를 크게 올려준다.

setup.py / 패키지 자동 생성

Phase 7에서 Jinja2 템플릿으로 setup.py가 자동 생성된다. entry_points로 cli-anything-{name} 명령을 PATH에 등록하는 패턴이 핵심.

REPL 인터페이스 설계 (ReplSkin)

16개 CLI가 모두 같은 룩앤필을 갖도록 한 모듈에 집중. prompt_toolkit, rich, ANSI 컬러로 통합 UX를 만드는 좋은 케이스 스터디다.

하드웨어·시스템 요구사항

의존성 + 운영체제별 주의.

직접 해볼 수 있는 5단계

난이도별 실습 — Easy → Hard.

실습 1 — 기존 CLI 그대로 써보기Easy

실습 2 — Claude Code 플러그인으로 작은 레포 변환Easy

실습 3 — 미지원 앱 어댑터 직접 작성Medium

실습 4 — SKILL.md 자동 생성기 직접 작성Medium

실습 5 — 새 AI 에이전트 플랫폼용 어댑터 작성Hard

8주 심화 학습 로드맵

주차별로 따라가면 CLI 패턴 마스터.

핵심 용어 한눈에

자주 마주칠 단어들.

더 깊이 파고들 자료

공식 · 명세 · 학습 리소스.

공식 자료

• HKUDS/CLI-Anything (GitHub)
• CLI-Anything Hub 공식 홈페이지
• TrendShift 페이지 (13위)
• CLI-Hub 브라우저
• 데모 영상 모음

핵심 명세 · 가이드

• HARNESS.md — 7단계 SOP 명세서
• Contributing Guide — 새 앱 추가 가이드
• Issues — 알려진 문제 및 토론

관련 라이브러리 · 학습 리소스

• Click 공식 문서
• Claude Code 공식 문서
• Pytest 공식 문서
• prompt_toolkit (REPL 빌딩)