Pp Ufo

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/ufo-goat/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

UFO GOAT — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the ufo-goat-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:

   npx -y @mvanhorn/printing-press-library install ufo-goat --cli-only

2. Verify: ufo-goat-pp-cli --version
3. Ensure $GOPATH/bin (or $HOME/go/bin) is on $PATH.

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

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

If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds.

The first CLI for the War.gov/UFO declassified files portal. Search across every contributing agency (DoD/DoW, FBI, NASA, State, CIA, DOE, ODNI, and more), download files with resume support, track new release tranches, and discover video-PDF pairings — all from a single binary with offline SQLite storage.

When to Use This CLI

Use this CLI when you need to browse, search, or download declassified UAP files from the War.gov PURSUE archive. Ideal for researchers tracking new releases, journalists investigating specific incidents, or agents that need structured access to government UFO data.

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

• sync — Automatically detect and fetch new file tranches as the government releases them on a rolling basis

  Agents monitoring the PURSUE release schedule get notified of new files without manual checking

  ufo-goat-pp-cli sync

• new — Show the files in the latest government release tranche — the 'what just dropped' command, scoped to the batch instead of your sync timing

  When an agent needs to see exactly what the most recent PURSUE batch contained, regardless of when it last synced. Use --release N for an older tranche, or --since/--since-sync for the old sync-timing behavior.

  ufo-goat-pp-cli new --agent
  ufo-goat-pp-cli new --release 1 --agent

• releases — Treat the PURSUE batch as a first-class lens: list every tranche, compare two, and detect when a new one lands

  The government declassifies files in batches (release_1, release_2, …). releases summarizes each batch's date, file count, and agency/type mix; releases check is the cron-friendly "did a new batch drop?" probe that exits 3 when nothing is new.

  ufo-goat-pp-cli releases --agent
  ufo-goat-pp-cli releases diff 1 2 --agent
  ufo-goat-pp-cli releases check --exit-code --agent

Cross-agency intelligence

• timeline — View a chronological incident timeline spanning 1944-2025 across every contributing agency

  Researchers need to see the full picture: FBI case from 1947 next to a DoW mission report from 2024

  ufo-goat-pp-cli timeline --after 1960 --before 1970

• pairs — Find video-PDF pairings so researchers can locate the document that accompanies a video and vice versa

  41 videos have paired documents — this command surfaces the connections instantly

  ufo-goat-pp-cli pairs --agent

• agencies — See which agency contributed what: file counts, types, date ranges, and coverage analysis

  Quick answer to 'what did the FBI release vs NASA vs DoW'

  ufo-goat-pp-cli agencies --json --select name,file_count,types

• locations — Aggregate incidents by geographic location for mapping and spatial analysis

  25 incidents in Western US, 12 in Syria, 9 on the Moon — spatial patterns emerge from aggregation

  ufo-goat-pp-cli locations --json

Agent-native plumbing

• download — Download files with resume support, verification, and progress tracking for the 2.3 GB archive

  The archive is 2.3 GB of PDFs alone — agents need reliable batch downloads with state tracking

  ufo-goat-pp-cli download --agency FBI --resume

Command Reference

agencies — Government agencies contributing to the PURSUE release

• ufo-goat-pp-cli agencies — List all contributing agencies with file counts

files — Declassified UAP files (PDFs, videos, images) from FBI, DoD, NASA, State Department

• ufo-goat-pp-cli files get — Get details of a specific file
• ufo-goat-pp-cli files list — List all declassified UAP files (filter by --agency, --type, --location, --release)
• ufo-goat-pp-cli files search — Full-text search across file titles, descriptions, and locations (--release scopes to a tranche)

releases — Browse the archive by government release tranche (batch)

• ufo-goat-pp-cli releases — Summarize every release tranche (number, date, file count, agency/type mix)
• ufo-goat-pp-cli releases diff <from> <to> — Compare the composition of two tranches
• ufo-goat-pp-cli releases check — Detect whether a new tranche has landed (--exit-code exits 3 when nothing new; --no-sync skips the fetch)

new — Show files in the latest release tranche

• ufo-goat-pp-cli new — Files in the latest tranche (--release N, or --since/--since-sync for sync-timing)

sources — Configure where the manifest is synced from

• ufo-goat-pp-cli sources — List known manifest sources (community/legacy/wargov)
• ufo-goat-pp-cli sync --source <name> — Sync from a named source (or --manifest-url <url>; env UFO_SOURCE / UFO_MANIFEST_URL). Default community tracks every release tranche.

Finding the right command

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

ufo-goat-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

Find all Moon incidents

ufo-goat-pp-cli files list --location Moon --json --select title,agency,incident_date

Surfaces Apollo-era lunar UAP observations from NASA files

Download all FBI files

ufo-goat-pp-cli download --agency FBI --resume

Batch download with resume support for the 56 FBI contributions

Cross-agency timeline for the 1960s

ufo-goat-pp-cli timeline --after 1960 --before 1970 --agent

See incidents across all agencies during the peak UFO era