# mvanhorn/cli-printing-press

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mvanhorn-cli-printing-press).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

4,931 stars · 539 forks · Go · MIT

## Links

- GitHub: https://github.com/mvanhorn/cli-printing-press
- awesome-repositories: https://awesome-repositories.com/repository/mvanhorn-cli-printing-press.md

## Topics

`ai-agents` `cli` `cli-generator` `developer-tools` `golang` `openapi`

## Description

Cli Printing Press is a generator that turns an API specification, documentation URL, website, or device into a complete command-line tool and a matching MCP server. The generated tools are built for AI agents: output switches to JSON when piped, a compact mode trims results to key fields, exit codes are typed for usage, authentication, not-found, service, and rate-limit errors, and a dry-run mode previews commands before they change anything. Both the command-line binary and the MCP server share the same HTTP client, authentication, and local store.

What sets it apart is how it gets to a spec and how it checks the result. It reads OpenAPI, GraphQL, JSON:API, SQL-query, and native YAML inputs, and when no official documentation exists it can infer a spec from captured browser traffic, community clients, or device evidence. Generated tools can optionally sync API resources into a local SQLite store with incremental cursors, which supports offline full-text search and cross-resource insight commands. Before shipping, each tool goes through build gates, structural comparison against its spec, mock or live runtime checks, read-only smoke tests, and a graded scorecard.

The wider surface covers the generation workflow and its release path. The workflow runs in phases with saved state, so long runs can resume, and it includes research into competing CLIs, amending, polishing, and reprinting existing tools. Authentication options include OAuth flows, cookie capture, and credential diagnostics. Packaging produces cross-platform binaries, checksums, release archives, a Homebrew formula, and desktop-agent extension bundles. The repository also carries pull-request merge-queue and workflow-security checks.

## Tags

### Development Tools & Productivity

- [Agent-First CLI Generators](https://awesome-repositories.com/f/development-tools-productivity/agent-first-cli-generators.md) — Generates command-line tools from API specifications with agent-oriented output modes, flags, and typed exit codes so AI agents can call them reliably. ([source](https://github.com/mvanhorn/cli-printing-press#readme))
- [API-to-CLI Generators](https://awesome-repositories.com/f/development-tools-productivity/api-to-cli-generators.md) — Take a specification or URL and produce a complete command-line project with per-resource commands, an HTTP client, and optional local storage for fast offline access. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/ONBOARDING.md))
- [CLI and MCP Interfaces](https://awesome-repositories.com/f/development-tools-productivity/command-line-interfaces/dual-interface-implementations/cli-and-mcp-interfaces.md) — Emits both a shell command-line binary and an MCP server from one specification, sharing client, store, and authentication without duplicated code. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/README.md))
- [Undocumented API Spec Recovery](https://awesome-repositories.com/f/development-tools-productivity/openapi-configurations/documentation-generators/openapi-specification-generators/mock-to-spec-conversion/specification-transformers/pre-generation-spec-transformations/client-side-spec-generation/undocumented-api-spec-recovery.md) — Recovers a usable API spec from captured browser traffic, community clients, or device evidence when no official documentation exists. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/CONCEPTS.md))
- [Agent Command Line Interfaces](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/cli-tooling-frameworks/cli-tooling/agent-integration-interfaces/agent-command-line-interfaces.md) — Produces command-line tools for AI agents with automatic JSON when piped, typed exit codes, dry-run previews, and compact output.

### DevOps & Infrastructure

- [API-to-CLI Generators](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/backend-as-a-service/authentication-as-a-service/api-to-cli-generators.md) — Turns an API specification, documentation URL, website, or device into a complete command-line tool with per-resource commands and an HTTP client.
- [Cross-Platform Package Releases](https://awesome-repositories.com/f/devops-infrastructure/cross-platform-package-releases.md) — Builds cross-platform binaries, checksummed release archives, a Homebrew formula, and desktop agent extension bundles so generated tools are easy to install.

### Artificial Intelligence & ML

- [Guided Build Workflows](https://awesome-repositories.com/f/artificial-intelligence-ml/guided-build-workflows.md) — Drives research, generation, targeted fixes, and a final quality check from a single assistant command, reusing earlier research at each step. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/ONBOARDING.md))
- [MCP Tool Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-tool-servers.md) — Emits an MCP server alongside the command-line tool, sharing client, store, and authentication so agents can discover and call every operation. ([source](https://github.com/mvanhorn/cli-printing-press#readme))
- [Local SQLite Stores](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-memory-storage/local-sqlite-stores.md) — Syncs API resources into a local SQLite store with incremental cursors, parallel workers, and batched writes for offline search and joins.
- [Code Quality Scoring](https://awesome-repositories.com/f/artificial-intelligence-ml/evaluation-metrics/scoring-pipelines/feature-cross-scoring/criteria-based-scoring-engines/code-quality-scoring.md) — Grades generated command-line tools against weighted quality criteria so weaknesses can be found and fixed before release. ([source](https://github.com/mvanhorn/cli-printing-press/tree/main/skills))

### Software Engineering & Architecture

- [API Reverse-Engineering Tools](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/data-integration-and-processing/http-api-references/reverse-engineered-api-references/api-reverse-engineering-tools.md) — Reconstructs API specs from captured browser traffic, community clients, or device evidence when no official documentation exists. ([source](https://github.com/mvanhorn/cli-printing-press#readme))
- [Template-Based CLI Generators From Specs](https://awesome-repositories.com/f/software-engineering-architecture/template-based-cli-generators-from-specs.md) — Converts one canonical API description into a complete command-line tool and matching server by filling templates, giving every output the same structure.
- [Multi-Format API Spec Normalizers](https://awesome-repositories.com/f/software-engineering-architecture/multi-format-api-spec-normalizers.md) — Detects OpenAPI, GraphQL, JSON:API, SQL-query, or native YAML inputs and converts them into one internal description for generation.
- [Code from Specification Generators](https://awesome-repositories.com/f/software-engineering-architecture/openapi-specification-parsers/go-code-generators/specification-from-code-generators/code-from-specification-generators.md) — Generates a first working command-line tool and a shell-agent operating guide from a validated specification, passing build, test, vet, and vulnerability gates. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/docs/PIPELINE.md))
- [CLI Command Generators](https://awesome-repositories.com/f/software-engineering-architecture/schema-driven-generators/cli-command-generators.md) — Produces command-line tools from API definitions with automatic JSON when piped, compact output, typed exit codes, dry-run mode, and actionable errors. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/README.md))
- [Traffic-Based API Spec Inference](https://awesome-repositories.com/f/software-engineering-architecture/traffic-based-api-spec-inference.md) — Records real browser or device traffic and infers endpoints, authentication, and request shapes to synthesize a spec when no official documentation exists.

### Testing & Quality Assurance

- [Generated CLI Quality Verification](https://awesome-repositories.com/f/testing-quality-assurance/generated-cli-quality-verification.md) — Scores each generated tool on infrastructure and domain correctness, checks paths, flags, and authentication against the spec, and optionally smoke-tests the live API. ([source](https://github.com/mvanhorn/cli-printing-press#readme))
- [Generated CLI Validation](https://awesome-repositories.com/f/testing-quality-assurance/generated-cli-validation.md) — Validates generated tools through build gates, structural comparison to the source spec, and runtime execution of every command with pass, warn, or fail verdicts. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/CONCEPTS.md))
- [Quality Gates](https://awesome-repositories.com/f/testing-quality-assurance/ci-integration-testing/quality-gates.md) — Runs each generated tool through build checks, spec comparison, mock or live runtime checks, and a graded scorecard before it ships.
- [Fake Implementation Detectors](https://awesome-repositories.com/f/testing-quality-assurance/fake-implementation-detectors.md) — Flags generated handlers that return hardcoded payloads, fake success messages, or invented reference data instead of calling the real service or synced store. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/AGENTS.md))
- [Generated CLI Reviews](https://awesome-repositories.com/f/testing-quality-assurance/generated-cli-reviews.md) — Runs one combined review of a regenerated tool covering structural dogfooding, runtime verification against a real or mock API, and a scorecard. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/docs/PIPELINE.md))
- [Generated Tool Quality Gates](https://awesome-repositories.com/f/testing-quality-assurance/generated-tool-quality-gates.md) — Runs dogfood, verify, scorecard, compile, vet, help, version, and doctor gates to confirm a generated tool is ready to ship. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/ONBOARDING.md))
- [Golden Fixture Output Checks](https://awesome-repositories.com/f/testing-quality-assurance/golden-fixture-output-checks.md) — Compares regenerated tool output against committed golden fixtures to catch unintended changes from edits to templates, naming, authentication, manifests, or scorecards. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/AGENTS.md))
- [Pre-Ship Validation Checks](https://awesome-repositories.com/f/testing-quality-assurance/pre-ship-validation-checks.md) — Runs shipcheck, dogfood, live matrix, narrative, and skill-drift checks and refuses unsafe forced regeneration over novel features. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/CHANGELOG.md))

### Data & Databases

- [Cross-Resource Insight Queries](https://awesome-repositories.com/f/data-databases/cross-resource-insight-queries.md) — Joins locally stored data across resources and history to answer questions about stale items, bottlenecks, duplicates, health scores, and trends. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/README.md))
- [Offline Search Memory](https://awesome-repositories.com/f/data-databases/offline-search-memory.md) — Runs full-text search and raw SQL over locally synced data on the user's machine in milliseconds, with no network access needed. ([source](https://github.com/mvanhorn/cli-printing-press#readme))
- [API Resource Syncs](https://awesome-repositories.com/f/data-databases/sqlite-storage/api-resource-syncs.md) — Syncs API resources into domain-specific SQLite tables with incremental cursors, parallel workers, and batched transactions for fast offline access. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/README.md))

### Hardware & IoT

- [Device Control Spec Descriptions](https://awesome-repositories.com/f/hardware-iot/device-control-spec-descriptions.md) — Builds command-line tools for websites through replayable captures and for Bluetooth devices from sniffed specs describing device control surfaces. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/CHANGELOG.md))

### System Administration & Monitoring

- [Long Run Monitoring and Resumption](https://awesome-repositories.com/f/system-administration-monitoring/long-run-monitoring-and-resumption.md) — Saves run state with phase seeds, research notes, and proof artifacts so long generation runs can resume across separate sessions. ([source](https://github.com/mvanhorn/cli-printing-press/blob/main/ONBOARDING.md))

### Web Development

- [Offline-First API Client with Sync](https://awesome-repositories.com/f/web-development/local-first-api-clients/offline-first-api-client-with-sync.md) — Syncs API resources into a local SQLite store with incremental cursors, enabling offline search and cross-resource insight queries.
