Other

War.gov UFO

pp-ufo-goat

Browse, search, and download declassified UAP files from the War.gov PURSUE archive

Printed by @davemorin (Dave Morin)

Install

npx — recommended

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

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-ufo-goat --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-ufo-goat skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-ufo-goat. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

The declassified UAP file archive in your terminal — browse, search, and download 162+ files from the PURSUE initiative

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

Authentication

No authentication required for browsing and searching the file manifest. The CSV manifest is fetched from GitHub (public). File downloads from war.gov may encounter Akamai bot protection (HTTP 403).

Environment variables:

Variable	Description
`UFO_BASE_URL`	Override the base URL (default: `https://raw.githubusercontent.com/DenisSergeevitch/UFO-USA/main/metadata`)
`UFO_CONFIG`	Override config file path (default: `~/.config/ufo-goat-pp-cli/config.json`)

Quick Start

# Check connectivity and local store status
ufo-goat-pp-cli doctor

# Fetch the latest file manifest from the PURSUE archive
ufo-goat-pp-cli sync

# Search across titles, descriptions, and locations
ufo-goat-pp-cli search "Apollo"

# View the chronological incident timeline
ufo-goat-pp-cli timeline --after 1960-01-01 --before 1970-12-31

# Find video-PDF pairings for cross-referencing
ufo-goat-pp-cli pairs

Unique Features

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 — See exactly which files were added since your last sync — the 'what did I miss' command for rolling releases

When an agent needs to check for new declassified files without re-scanning the entire archive
```
ufo-goat-pp-cli new --since 7d
```

Cross-agency intelligence

timeline — View a chronological incident timeline spanning 1944-2025 across all four agencies

Researchers need to see the full picture: FBI case from 1947 next to a DoD mission report from 2024
```
ufo-goat-pp-cli timeline --after 1940-01-01 --before 1949-12-31
```
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 DoD'
```
ufo-goat-pp-cli agencies --json
```
locations — Aggregate incidents by geographic location for mapping and spatial analysis

Spatial patterns emerge from aggregation across all agencies
```
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
```

Commands

File Archive

Command	Description
`files list`	List all declassified UAP files from local store
`files get`	Get details of a specific file by ID or title
`files search`	Full-text search across titles, descriptions, and locations
`search`	Top-level shortcut for `files search`
`download`	Download files from war.gov with resume support

Cross-Agency Analysis

Command	Description
`agencies`	Agency breakdown with file counts and type coverage
`timeline`	Chronological incident timeline, 1944-2025
`pairs`	Video-PDF pairings for cross-referencing
`locations`	Incidents aggregated by geographic location

Data Management

Command	Description
`sync`	Sync the UAP file manifest from GitHub to local SQLite
`new`	Show files added since your last sync
`analytics`	Run analytics queries on locally synced data
`export`	Export data to JSONL or JSON
`import`	Import data from JSONL file

Utilities

Command	Description
`doctor`	Check CLI health and connectivity
`workflow archive`	Sync all resources for offline access
`workflow status`	Show local archive status and sync state
`profile`	Named sets of flags saved for reuse
`which`	Find the command that implements a capability
`agent-context`	Emit structured JSON describing this CLI for agents
`api`	Browse all API endpoints by interface name
`tail`	Stream live changes by polling the API
`feedback`	Record feedback about this CLI

Output Formats

# Human-readable table (default in terminal, JSON when piped)
ufo-goat-pp-cli agencies

# JSON for scripting and agents
ufo-goat-pp-cli agencies --json

# Filter to specific fields
ufo-goat-pp-cli files list --json --select id,title,agency

# CSV output
ufo-goat-pp-cli files list --csv

# Compact output (key fields only, minimal tokens)
ufo-goat-pp-cli files list --compact

# Dry run — show the request without sending
ufo-goat-pp-cli agencies --dry-run

# Agent mode — JSON + compact + no prompts in one flag
ufo-goat-pp-cli agencies --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive — never prompts, every input is a flag
Pipeable — --json output to stdout, errors to stderr
Filterable — --select id,title returns only fields you need
Previewable — --dry-run shows the request without sending
Read-only by default — this CLI does not create, update, delete, publish, send, or mutate remote resources
Offline-friendly — sync/search commands use the local SQLite store
Agent-safe by default — no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

ufo-goat-pp-cli doctor

Example output:

  OK Config: ok
  OK Auth: not required
  OK API: reachable
  config_path: ~/.config/ufo-goat-pp-cli/config.json
  base_url: https://raw.githubusercontent.com/DenisSergeevitch/UFO-USA/main/metadata
  version: 1.0.0
  OK Cache: fresh
    db_path: ~/.local/share/ufo-goat-pp-cli/data.db

Cookbook

# Sync and check for new files in one pass
ufo-goat-pp-cli sync && ufo-goat-pp-cli new

# List all FBI PDFs from the 1950s
ufo-goat-pp-cli files list --agency FBI --type PDF --after 1950-01-01 --before 1959-12-31

# Search for incidents in New Mexico
ufo-goat-pp-cli search "New Mexico" --json

# Export the full archive as JSONL for external analysis
ufo-goat-pp-cli export files --format jsonl --output ufo-archive.jsonl

# Download only NASA videos
ufo-goat-pp-cli download --agency NASA --type VID --output-dir ~/ufo-videos

# Resume an interrupted download
ufo-goat-pp-cli download --resume

# Get agency breakdown as CSV for a spreadsheet
ufo-goat-pp-cli agencies --csv

# View timeline of 1940s incidents as JSON for an agent
ufo-goat-pp-cli timeline --after 1940-01-01 --before 1949-12-31 --agent

# Find all video-PDF pairs and pipe to jq
ufo-goat-pp-cli pairs --json | jq '.[].video_title'

# Run analytics on synced data grouped by agency
ufo-goat-pp-cli analytics --type files --group-by agency --json

# Check what files were added in the last week
ufo-goat-pp-cli new --since 1w --json

# Full resync after a data correction
ufo-goat-pp-cli sync --full

Configuration

Config file: ~/.config/ufo-goat-pp-cli/config.json

Variable	Description	Default
`UFO_BASE_URL`	Override API base URL	`https://raw.githubusercontent.com/DenisSergeevitch/UFO-USA/main/metadata`
`UFO_CONFIG`	Override config file path	`~/.config/ufo-goat-pp-cli/config.json`

Database: ~/.local/share/ufo-goat-pp-cli/data.db (SQLite, created on first sync)

Troubleshooting

Config errors (exit code 10)

Run ufo-goat-pp-cli doctor to verify configuration
Check that ~/.config/ufo-goat-pp-cli/config.json is valid JSON (if it exists)

Not found errors (exit code 3)

Check the resource ID is correct
Run ufo-goat-pp-cli files list to see available items
Run ufo-goat-pp-cli sync if the local store is empty

API errors (exit code 5)

Check internet connectivity — the manifest is fetched from GitHub
Run ufo-goat-pp-cli doctor to verify API reachability

Rate limited (exit code 7)

GitHub rate limits raw content at 5000 req/hr
Wait and retry, or use --rate-limit 1 to throttle

API-specific

403 Forbidden when downloading files — war.gov is behind Akamai CDN and may block direct HTTP requests. Try downloading fewer files at a time.
Empty results from sync — Check internet connectivity. The manifest is fetched from GitHub. Run ufo-goat-pp-cli doctor to verify.
No new files found — New tranches are released periodically. Run ufo-goat-pp-cli sync to check for updates.

Sources & Inspiration

This CLI was built by studying these projects and resources:

Generated by CLI Printing Press