cli-printing-press  by mvanhorn

Summary

This project addresses the challenge of creating efficient, agent-native CLIs by automating the generation of powerful command-line tools for any API or website. It targets AI agents and power users, offering significant time and token savings through intelligent feature absorption, local data persistence, and advanced compound commands.

How It Works

The Printing Press analyzes API documentation, community tools, and live web traffic to reverse-engineer APIs. It then generates a Go CLI and an MCP server, incorporating features from competing tools and adding unique capabilities like local SQLite databases with full-text search, offline sync, and agent-native flags. This approach prioritizes depth and domain understanding over simple endpoint wrapping.

Quick Start & Requirements

• Prerequisites: Go 1.26.3+ and Claude Code.
• Installation: Install the binary via go install github.com/mvanhorn/cli-printing-press/v4/cmd/printing-press@latest and integrate Claude Code skills using gh skill install mvanhorn/cli-printing-press --agent claude-code --scope user or npx skills add mvanhorn/cli-printing-press/skills -g -a claude-code -y.
• Usage: Execute /printing-press <app-name> or /printing-press <url> within Claude Code.
• Resources: Official catalog at printingpress.dev.

Highlighted Details

• "GOAT CLI" Generation: Automatically absorbs and surpasses features from existing tools, creating comprehensive CLIs.
• Local Data Layer: Employs SQLite with FTS5 for fast offline search, incremental sync, and compound queries impossible for stateless wrappers.
• Agent-Native UX: Features optimized flags (--json, --compact), auto-JSON piping, and typed exit codes for seamless AI agent integration.
• Website API Discovery: Generates CLIs for undocumented APIs by capturing browser traffic or processing HAR files.
• Dual Interface: Produces both a Cobra CLI (<api>-pp-cli) and an MCP server (<api>-pp-mcp) from a single specification.
• Rigorous Verification: Employs a four-stage mechanical check process (scorecard, dogfood, proof-of-behavior, live API smoke test) to ensure quality and correctness.
• Domain Archetypes: Automatically classifies APIs (e.g., Project Management, Payments) to generate relevant workflow and insight commands.

Maintenance & Community

The project credits key contributors like Peter Steinberger and Trevin Chow, whose work heavily influenced its design. While explicit community channels aren't detailed, the project emphasizes community contributions and learning from existing ecosystem tools.

Licensing & Compatibility

Licensed under the permissive MIT license, allowing for broad commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

Requires Go 1.26.3+ and Claude Code; no standalone distribution is available. Generated CLIs focus on power-user functionality rather than exhaustive vendor-specific features. Browser-based API discovery requires manual capture, and live verification is strictly read-only. The regen-merge subcommand is limited to macOS and Linux.