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 サーバーを生成します。両者は共通の内部クライアントとデータストアを共有し、コードの重複をゼロにします。
  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: 「polish」フェーズを含み、実際の使用診断に基づいてデッドコードを修正し README を改善。