CLI Printing Press — 모든 API를
에이전트용 "GOAT CLI"로
인쇄하는 공장

2.4k 스타. /printing-press Notion 한 줄로 어떤 API든 ① Cobra CLI + ② MCP 서버 + ③ Claude Code 스킬 세 개를 동시에 인쇄한다. 핵심 트릭은 단순한 endpoint 래퍼가 아니라 로컬 SQLite 데이터 레이어 + FTS5 풀텍스트 검색 + 도메인 분석 명령까지 자동 생성한다는 것. OpenAPI 스펙이 없으면 브라우저를 직접 띄워 트래픽을 가로채 만들어낸다. ESPN·Google Flights처럼 공식 API가 없는 사이트도 깎아낼 수 있다.

0먼저, 이게 도대체 뭘 만드는 도구인가

"API 하나당 CLI 한 개"가 아니라, "API 하나당 CLI + MCP + 스킬 세트"를 자동으로 깎아내는 공장.

대부분의 사람들은 swagger-codegen이나 openapi-generator 같은 도구를 안다. OpenAPI 스펙(JSON/YAML)을 던지면 그 API를 부르는 클라이언트 라이브러리를 자동 생성하는 도구다. CLI Printing Press는 같은 입구로 들어오지만 출구가 완전히 다르다.

일반적인 코드 제너레이터는 endpoint 하나당 함수 하나를 만들고 끝낸다. Printing Press는 그 위에 네 겹을 더 쌓는다:

• (1) endpoint 래퍼 — 일반 제너레이터가 해주는 평범한 일
• (2) 로컬 SQLite + FTS5 데이터 레이어 — 데이터를 다운로드해서 로컬에 인덱싱
• (3) 도메인 분석 명령 — stale(오래된 이슈), health(종합 점수), bottleneck(병목) 같은, API 자체로는 절대 불가능한 복합 질의
• (4) 에이전트 친화 출력 — 파이프로 넘기면 자동 JSON, --compact로 60~80% 토큰 절감, 타입드 종료 코드
• (5) MCP 서버 — Claude Desktop·Cursor·Windsurf가 자동 발견할 수 있게 같은 기능을 MCP로도 노출

출력물은 매번 두 개의 실행 파일이다 — <api>-pp-cli(셸 에이전트·사람용)와 <api>-pp-mcp(Claude Desktop·Cursor용). 둘 다 같은 internal/client, 같은 internal/store, 같은 인증 코드를 공유한다. 코드 중복이 없다.

1프로젝트 한 줄 요약

"메뉴판은 다 베끼고, 그 위에 진짜 가치를 인쇄한다."

2왜 지금 주목받는가

"AI 에이전트가 일하는 시대에는, 도구의 토큰 효율이 곧 비용이다."

2026년 5월 TrendShift Daily 19위에 진입한 이유는 단순히 "또 다른 CLI 제너레이터"가 아니기 때문이다. 이 도구가 해결하는 진짜 문제는 "AI 에이전트가 API를 호출할 때 토큰을 얼마나 태우느냐"다.

3기술 스택 전체 지도

Go 84.7% + Go 템플릿 13.8% + Python(스킬 헬퍼) + Shell.

레포는 1,243 커밋, 68 릴리즈, 활발한 단일 활동을 보이는 1인 + 일부 컨트리뷰터 프로젝트다. 디렉토리 윤곽을 보면 "코드 생성기 그 자체"와 "생성된 CLI가 사용할 라이브러리"가 잘 분리돼 있다.

핵심 의존성 — 잘 알려진 Go OSS만 사용

여기서 중요한 건 "생성기"와 "생성된 결과물"의 의존성이 다르다는 점이다. 생성기 자체는 Go로 짜여 있고, 생성된 CLI도 Go 출력물이다. 둘 다 Go 1.26.3+이 필요하다.

인프라 — Goreleaser + lefthook + 골든 테스트

이 설정 묶음은 단순히 도구가 아니라 "인프라로서의 에이전트 친화성"을 보여준다. 골든 테스트는 "같은 입력에 항상 같은 출력"을 강제해, AI가 코드를 짜더라도 회귀가 발생하면 즉시 잡힌다. 1,243 커밋 동안 안정적으로 굴러간 비결.

4아키텍처 심화 분석

8단계 파이프라인이 한 줄 슬래시 명령 뒤에 숨어 있다.

/printing-press Notion 한 줄을 입력하면 어떤 일이 벌어지는가? 표면에서 보면 30분 안에 두 개의 바이너리가 나온다. 안에서는 8단계 파이프라인이 차례로 굴러간다.

핵심 설계 패턴 1: NOI(Non-Obvious Insight) — 모든 CLI의 창의적 DNA

NOI 예시 8선 — 이게 왜 중요한지 한눈에 보인다:

핵심 설계 패턴 2: 창의력 사다리 (Creativity Ladder) — 5단까지 자동 등반

대부분의 코드 제너레이터는 1단에서 멈춘다. Printing Press는 5단까지 올라간다.

3단은 테이블 스테이크(기본). 4단은 discrawl이 사는 곳. 5단은 아직 아무도 안 가본 곳이다.

핵심 설계 패턴 3: 도메인 원형(Archetype) — 자동 분류 + 자동 명령

스펙을 받자마자 분류기가 API를 다섯 가지 원형 중 하나로 분류한다. 그러면 그 원형에 맞는 워크플로 명령이 자동으로 끼워진다.

핵심 설계 패턴 4: 두 단계 점수표(Two-tier Scorecard) — Grade A는 85점 이상

각 CLI는 100점 만점 점수표를 받는다. 두 단계로 나뉘어 있다.

핵심 설계 패턴 5: 행동 증명(Proof of Behavior)

점수표가 구조를 본다면, 행동 증명은 데이터 흐름을 본다. 4가지 강제 증명:

• Path Proof — 생성된 명령의 모든 URL이 OpenAPI 스펙에 실재
• Flag Proof — 등록된 모든 플래그가 적어도 한 명령에서 참조됨
• Pipeline Proof — 모든 SQLite 테이블에 WRITE 경로(sync)와 READ 경로(search/query) 존재
• Auth Proof — auth 헤더 포맷이 스펙의 securitySchemes와 일치

어떤 증명이라도 실패하면 자동 교정이 데드 코드를 제거하고 재검증한다. 환각된 경로(hallucinated paths)와 auth 불일치는 하드 FAIL 게이트 — 그 자체로 CLI 출시 불가.

5디렉토리 구조 해부

"생성기 본체"와 "생성물의 골격"이 어디서 갈리는가.

이 레포의 디렉토리 윤곽이 중요한 이유는 "이 도구가 만들어내는 것"과 "이 도구 자체의 코드"가 다르기 때문이다. cmd/cli-printing-press는 생성기, internal/은 생성기의 두뇌, skills/는 Claude Code 인터페이스, catalog/는 미리 검증된 API 목록.

생성된 CLI의 디렉토리 구조 (참고)

위는 "생성기" 디렉토리. 그럼 /printing-press Notion의 결과로 나오는 notion-pp-cli 디렉토리는 어떻게 생겼을까?

이 구조는 모든 CLI가 똑같다. 어떤 API든 같은 골격. 그게 점수표와 검증을 자동화할 수 있는 이유다. 한 번 검증기를 짜두면 모든 생성물에 적용된다.

6학습 포인트 (기술별)

이 레포에서 실제로 무엇을 배울 수 있는가.

단순히 도구를 쓰는 게 아니라 이 레포의 코드를 읽으면서 얻을 수 있는 것들이다. 각 기술별로 "왜 그렇게 짰는지"가 명시돼 있어서 학습 자료로도 좋다.

7하드웨어/시스템 요구사항

"가벼운 도구치고는 환경이 까다롭다 — Go + Claude Code가 둘 다 필요하다."

이 도구는 코드 생성 + LLM 호출 + 브라우저 자동화를 모두 하기 때문에 환경 요구사항이 명확하다.

토큰 비용 — 솔직한 추정: 표준 Opus 모드로 Phase 0~5를 끝까지 돌리면 한 API당 대략 $10~$30 정도가 든다(API 복잡도에 따라). Codex 모드는 약 40% 수준. Phase 1 연구는 Sonnet으로 충분히 가능하다는 후기도 있다.

8직접 해볼 수 있는 실습 과제

난이도별 5개 — 1번부터 5번까지 사다리 식으로 어려워진다.

9관련 기술 심화 학습 로드맵

"Printing Press를 정복하려면 6주 코스로 가야 한다."

한 번에 다 익히려고 하지 말고, 6주 동안 한 주에 하나씩 깊게 파는 게 효율적이다. 각 주차의 학습은 다음 주를 위한 토대가 된다.

10핵심 키워드 사전

이 레포·문서에서 자주 나오는 용어 한곳에 정리.

11참고 링크

원본 문서·자매 레포·영감의 원천을 한 곳에.