pp-american-reindustrialization

American Reindustrialization — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the american-reindustrialization-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install american-reindustrialization --cli-only
   

2. Verify: american-reindustrialization-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.5 or newer):

go install github.com/mvanhorn/printing-press-library/library/other/american-reindustrialization/cmd/american-reindustrialization-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Reach for this CLI when an agent or analyst needs to slice, join, or analyze the americanreindustrialization.com company directory and jobs board beyond what the website's filter UI exposes. The local SQLite store enables composed cross-resource filters (jobs at companies with property X), aggregate analytics (sector × state heatmaps, funding × sector crosstabs, salary distributions), and diff over time (whats-new since a prior sync). Pair --select with --json whenever an agent only needs a subset of the ~30 fields per company.

When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• whats-new — Show companies and jobs added or updated since a date you provide, so a weekly sweep takes one command instead of an eyeball-the-list session.

  Reach for this when an analyst or agent needs week-over-week deltas across the directory; the site offers no such view.

  american-reindustrialization-pp-cli whats-new --since 2026-05-12 --json
  

Cross-entity local queries

• openings find — Filter the jobs board by work_mode, experience_level, salary floor, state, company size, sector, and posted-since in a single query — combinations the website's UI cannot express.

  Use this when a user wants the shortlist instead of 25 paginated pages; cross-resource filters are this CLI's reason to exist.

  american-reindustrialization-pp-cli openings find --work-mode remote --experience senior --salary-min 150000 --state TX --json
  

• companies top-hiring — Rank companies by jobs_count descending, with optional filters by sector, state, or funding_stage — the site has no ranking view.

  Reach for this when a job seeker or recruiter wants 'who has the most openings in sector X right now'.

  american-reindustrialization-pp-cli companies top-hiring --sector robotics --limit 10 --json
  

• companies profile — Single-shot rich profile for one company: full fields plus that company's open jobs plus similar companies (same primary_sector and employee_range bucket).

  Use this when a single named company needs full context plus peers — research, due diligence, competitor scans.

  american-reindustrialization-pp-cli companies profile harmony-ai --json
  

Ecosystem analytics

• analytics sector-heatmap — Crosstab of primary_sector × HQ state with company counts (optionally weighted by jobs_count or filtered by funding_stage), revealing the geographic shape of each sector.

  Pull this when answering 'where is sector X clustering' or 'which states are bidding loudest on hiring in sector Y'.

  american-reindustrialization-pp-cli analytics sector-heatmap --funding-stage seed --weight jobs --json
  

• analytics funding-by-sector — Crosstab of funding_stage × primary_sector with company counts and median employee_range, exposing where capital is concentrating.

  Use this when an investor needs the capital map across the reindustrialization directory.

  american-reindustrialization-pp-cli analytics funding-by-sector --json
  

• analytics geo-clusters — Grid-bucket companies by lat/lon (default 50km cells) and emit cluster centroid, member count, member companies, and the dominant sector per cluster.

  Pull this for 'which metro is the densest cluster in sector X' style questions; the site has no map view.

  american-reindustrialization-pp-cli analytics geo-clusters --state TX --radius-km 50 --json
  

• openings salary-stats — p25 / p50 / p75 of midpoint salary across filtered jobs, with null-salary count reported separately so missing data is honest.

  Use this when a job seeker or comp analyst wants band ranges, not individual postings.

  american-reindustrialization-pp-cli openings salary-stats --sector robotics --experience senior --json
  

• companies cohorts — Bucket companies by founded_year (default 5-year buckets) with company counts and the top-3 sectors per cohort.

  Reach for this when writing about 'companies founded since 2020 in the reindustrialization wave' or tracking ecosystem age over time.

  american-reindustrialization-pp-cli companies cohorts --bucket 5 --json
  

Command Reference

categories — Top-level sectors (hierarchical via parent_id)

• american-reindustrialization-pp-cli categories counts — Map of category_id -> company count
• american-reindustrialization-pp-cli categories get — Get one category by slug
• american-reindustrialization-pp-cli categories list — List every category (bare array)
• american-reindustrialization-pp-cli categories search — Search categories by query string

companies — US-based companies driving reindustrialization (manufacturing, robotics, advanced materials, supply chains)

• american-reindustrialization-pp-cli companies get — Get one company by slug (returns the full object directly, not wrapped)
• american-reindustrialization-pp-cli companies list — List companies with pagination and optional server-side filters
• american-reindustrialization-pp-cli companies search — Full-text search across company names and descriptions; returns a bare array

news — News feed (currently empty upstream; reserved for future API population)

• american-reindustrialization-pp-cli news — List news items (returns a bare array; empty at capture)

openings — Open job listings aggregated from companies in the directory

• american-reindustrialization-pp-cli openings categories — Autocomplete list of categories that have at least one opening
• american-reindustrialization-pp-cli openings companies — Autocomplete list of {id, name} for companies that currently have open openings
• american-reindustrialization-pp-cli openings get — Get one job opening by slug
• american-reindustrialization-pp-cli openings list — List job openings with pagination and optional server-side filters (work_mode and experience_level are honored;...
• american-reindustrialization-pp-cli openings tags — Autocomplete list of tags that appear on at least one opening
• american-reindustrialization-pp-cli openings titles — Autocomplete list of job titles matching the query

tags — Typed tags (tag_type = tech, sector, focus area, etc.)

• american-reindustrialization-pp-cli tags counts — Map of tag_id -> company count
• american-reindustrialization-pp-cli tags get — Get one tag by slug
• american-reindustrialization-pp-cli tags list — List every tag (bare array)
• american-reindustrialization-pp-cli tags search — Search tags by query string

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

american-reindustrialization-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Where are senior remote robotics roles paying well?

american-reindustrialization-pp-cli openings find --work-mode remote --experience senior --sector robotics --salary-min 150000 --json --select title,company.name,location_display,salary_min,salary_max,apply_url

Composed filter + field pruning — agent gets a tight shortlist payload instead of 25 paginated full-body responses.

Weekly investor sweep

american-reindustrialization-pp-cli whats-new --since 2026-05-12 --json --select kind,slug,name,primary_sector,funding_stage,hq_state

Diff-since-last-sync limited to the deal-flow fields; one command replaces a Monday morning eyeball-the-list session.

Sector geography map

american-reindustrialization-pp-cli analytics geo-clusters --radius-km 75 --csv

Grid-bucket every company by lat/lon at 75km cells, emit centroid + members + dominant sector as CSV for downstream mapping.

Capital map across the directory

american-reindustrialization-pp-cli analytics funding-by-sector --json

Crosstab of funding_stage × primary_sector — answers 'where is capital concentrating' in one local query.

Auth Setup

No authentication required.

Run american-reindustrialization-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable — JSON on stdout, errors on stderr

• Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  american-reindustrialization-pp-cli categories list --agent --select id,name,status
  

• Previewable — --dry-run shows the request without sending

• Offline-friendly — sync/search commands can use the local SQLite store when available

• Non-interactive — never prompts, every input is a flag

• Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

american-reindustrialization-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
american-reindustrialization-pp-cli feedback --stdin < notes.txt
american-reindustrialization-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.american-reindustrialization-pp-cli/feedback.jsonl. They are never POSTed unless AMERICAN_REINDUSTRIALIZATION_FEEDBACK_ENDPOINT is set AND either --send is passed or AMERICAN_REINDUSTRIALIZATION_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

american-reindustrialization-pp-cli profile save briefing --json
american-reindustrialization-pp-cli --profile briefing categories list
american-reindustrialization-pp-cli profile list --json
american-reindustrialization-pp-cli profile show briefing
american-reindustrialization-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

Argument Parsing

Parse $ARGUMENTS:

1. Empty, help, or --help → show american-reindustrialization-pp-cli --help output
2. Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
3. Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:

claude mcp add american-reindustrialization-pp-mcp -- american-reindustrialization-pp-mcp

Verify: claude mcp list

Direct Use

1. Check if installed: which american-reindustrialization-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
3. Execute with the --agent flag:

   american-reindustrialization-pp-cli <command> [subcommand] [args] --agent
   

4. If ambiguous, drill into subcommand help: american-reindustrialization-pp-cli <command> --help.