This repository provides a catalog of Command Line Interface (CLI) tools generated by the CLI Printing Press, designed to enhance the speed and efficiency of AI agents by offering pre-built, easily accessible commands. It targets developers and power users who need to reduce token spend and development time associated with complex tasks. The primary benefit is providing a curated set of robust CLIs that act as "muscle memory" for agents, eliminating the need for extensive documentation lookups or trial-and-error.

How It Works

The project functions as a registry (registry.json) of available CLIs, which are primarily Go binaries. An npm package acts as a thin orchestrator, reading the registry, resolving Go module paths, and executing go install for the specified CLI binary. Companion "skills" (focused interfaces) are also installed from the cli-skills/pp-<name> directory. Each published tool is self-contained, including source code, a local README, a provenance manifest (.printing-press.json), and build manuscripts. Tools undergo validation, including generation checks, build, vet, vulnerability scans, and runtime verification, before being endorsed.

Quick Start & Requirements

• Starter Pack Installation: npx -y @mvanhorn/printing-press install starter-pack installs four CLIs: espn, flight-goat, movie-goat, and recipe-goat.
• Individual CLI Installation: npx -y @mvanhorn/printing-press install <cli-name>
• Binary-Only Install: Requires Go 1.26.3+ (go install github.com/mvanhorn/printing-press-library/<path>/cmd/<binary>@latest).
• Prerequisites: Requires GITHUB_TOKEN or GH_TOKEN for catalog and skill fetches, and working private Go module access for go install.
• Documentation: Catalog available at printingpress.dev.

Highlighted Details

• Extensive Catalog: Features 52 CLIs across 12 categories, integrating diverse data sources like ESPN, Kayak, Google Flights, TMDb, and Ahrefs.
• Local Data Persistence: Many CLIs leverage local SQLite databases for historical data, caching, advanced querying (e.g., Sentry issues, Craigslist trends), and offline functionality.
• Compound Queries: Enables complex queries not directly supported by underlying APIs, such as combining data from multiple sources or performing intricate analysis (e.g., sentry-pp-cli, company-goat).
• Advanced Interactions: Includes CLIs capable of bypassing web protections (e.g., Cloudflare via Surf-Chrome), interacting with GraphQL APIs directly, and utilizing internal API endpoints.

Maintenance & Community

No specific details regarding maintainers, sponsorships, or community channels (like Discord/Slack) are provided in the README. Links to CONTRIBUTING.md and AGENTS.md are available for deeper architectural insights and contribution guidelines.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license is permissive, generally allowing for commercial use and integration within closed-source projects without significant restrictions.

Limitations & Caveats

The catalog repository itself is private. Installation and fetching of catalog/skills necessitate authentication via GITHUB_TOKEN or GH_TOKEN. Additionally, users require working private Go module access for the go install command, and binary-only installations specifically mandate Go version 1.26.3 or newer.