mvanhorn/cli-printing-press

Every API has a secret identity. This finds it, absorbs every feature from every competing tool, then builds the GOAT CLI — designed for AI agents first, with SQLite sync, offline search, and compound insight commands.

What it solves

CLI Printing Press는 AI 에이전트가 API와 상호작용할 때 발생하는 비효율성을 해결합니다. 에이전트가 문서를 뒤져다니거나 복잡한 API 호출에 토큰을 낭비하는 대신, 이 도구는 고성능·토큰 효율적인 명령줄 인터페이스(CLI)와 Model Context Protocol(MCP) 서버를 자동으로 생성해 AI 에이전트에 최적화합니다.

How it works

시스템은 API 또는 웹사이트를 기능적인 툴셋으로 변환하기 위해 다단계 파이프라인을 따릅니다.

  1. Research & Absorption: 공식 API 문서를 분석하고, 기존 커뮤니티 툴(CLI, MCP 서버)을 조사합니다. 공식 스펙이 없는 API는 브라우저 트래픽을 "스니핑"해 역공학할 수도 있습니다.
  2. The Non-Obvious Insight (NOI): API의 "비밀 정체성"을 찾아 데이터를 재구성해 더 깊은 인사이트를 제공합니다(예: Discord를 단순 채팅 앱이 아닌 검색 가능한 지식 베이스로 취급).
  3. Generation: Go 기반 CLI와 매칭되는 MCP 서버를 생성합니다. 두 구성 요소는 공통 내부 클라이언트와 데이터 스토어를 공유해 코드 중복을 0으로 만듭니다.
  4. Local-First Data Layer: 로컬 SQLite 데이터베이스(FTS5 전체 텍스트 검색 및 증분 동기화)를 구현해 에이전트가 복합 쿼리(예: "오래된" 이슈 찾기)를 수행하도록 합니다. 무상태 API가 처리할 수 없는 복잡한 검색이 가능합니다.
  5. Verification: 생성된 툴은 기계적 검증을 거칩니다. 자체 사용(dogfooding)과 실시간 API 스모크 테스트를 통해 환각(허위 응답)을 방지합니다.

Who it’s for

  • AI Agent Developers: Claude Code, Codex, Cursor, Windsurf 등으로 개발하는 개발자들로, 에이전트에 신뢰성 높고 토큰 비용이 낮은 툴을 제공하고자 하는 분.
  • Power Users: 오프라인 분석 및 복잡한 쿼리를 위해 API 데이터를 로컬에서 검색 가능한 형태로 미러링하고 싶은 사용자.
  • Tool Builders: 어떤 웹 서비스든 빠르게 전문 수준의 CLI와 MCP 서버를 생성하고자 하는 모든 사람.

Highlights

  • Dual Interface: 단일 사양에서 Cobra CLI(쉘 에이전트용)와 MCP 서버(IDE 에이전트용)를 동시에 생성.
  • Browser-Sniffing: OpenAPI 스펙이 없어도 트래픽을 캡처해 어떤 웹사이트든 CLI를 만들 수 있습니다.
  • Agent-Native Design: 자동 JSON 출력, 자체 교정을 위한 타입화된 종료 코드, --compact 플래그로 토큰 사용량을 60‑80% 절감.
  • Compound Commands: 로컬 SQLite 영속화를 활용해 표준 API 래퍼로는 불가능한 분석 및 행동 인사이트 제공.
  • Automated Polish: 실제 사용 진단을 기반으로 죽은 코드를 수정하고 README를 개선하는 "polish" 단계 포함.