Back to Details

pp-ufo-goat

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

War.gov UFO — Printing Press CLI

War.gov UFO — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装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:
    bash
    npx -y @mvanhorn/printing-press 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.23+):
bash
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 all four agencies (DoW, 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.
本技能基于
ufo-goat-pp-cli
二进制文件运行。在调用本技能的任何命令前，你必须确认CLI已安装。 如果未安装，请先执行以下步骤：
  1. 通过Printing Press安装器安装：
    bash
    npx -y @mvanhorn/printing-press install ufo-goat --cli-only
  2. 验证安装：
    ufo-goat-pp-cli --version
  3. 确保
    $GOPATH/bin
    （或
    $HOME/go/bin
    ）已添加到
    $PATH
    环境变量中。
如果
npx
安装失败（无Node环境、离线等情况），可改用Go直接安装（要求Go 1.23+版本）：
bash
go install github.com/mvanhorn/printing-press-library/library/other/ufo-goat/cmd/ufo-goat-pp-cli@latest
如果执行
--version
时提示“command not found”，说明安装未将二进制文件添加到
$PATH
中。请在验证成功前不要执行本技能的命令。
这是首个针对War.gov/UFO解密文件门户的CLI工具。支持跨四大机构（DoW、FBI、NASA、国务院）搜索、断点续传下载文件、追踪新发布批次、发现视频与PDF配对文件——所有功能都通过单个二进制文件实现，并支持离线SQLite存储。

When to Use This CLI

何时使用本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.
当你需要浏览、搜索或下载War.gov PURSUE归档中的解密UAP文件时，可使用本CLI。非常适合追踪新发布内容的研究人员、调查特定事件的记者，或需要结构化访问政府UFO数据的Agent。

When Not to Use This CLI

何时不使用本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.
请勿针对需要创建、更新、删除、发布、评论、点赞、邀请、订购、发送消息、预订、购买或修改远程状态的请求激活本CLI。本CLI仅提供用于查看、导出、同步和分析的只读命令。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.
这些功能是其他同类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
    bash
    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
    bash
    ufo-goat-pp-cli new --since 7d
  • sync
     —— 自动检测并获取政府滚动发布的新文件批次
    监控PURSUE发布计划的Agent无需手动检查即可收到新文件通知
    bash
    ufo-goat-pp-cli sync
  • new
     —— 查看自上次同步以来新增的所有文件——这是针对滚动发布内容的“我错过了什么”命令
    当Agent需要检查新增解密文件而无需重新扫描整个归档时使用
    bash
    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 DoW mission report from 2024
    bash
    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
    bash
    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'
    bash
    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
    bash
    ufo-goat-pp-cli locations --json
  • timeline
     —— 查看涵盖1944-2025年、跨四大机构的事件时间线
    研究人员需要完整视角：1947年的FBI案件与2024年的DoW任务报告并列展示
    bash
    ufo-goat-pp-cli timeline --after 1960 --before 1970
  • pairs
     —— 查找视频与PDF配对文件，帮助研究人员定位视频对应的文档，反之亦然
    有41个视频配有对应文档——该命令可立即显示这些关联
    bash
    ufo-goat-pp-cli pairs --agent
  • agencies
     —— 查看各机构的贡献情况：文件数量、类型、日期范围及覆盖分析
    快速解答“FBI、NASA和DoW分别发布了什么内容”
    bash
    ufo-goat-pp-cli agencies --json --select name,file_count,types
  • locations
     —— 按地理位置汇总事件，用于地图绘制和空间分析
    美国西部25起事件、叙利亚12起、月球9起——汇总后可呈现空间分布模式
    bash
    ufo-goat-pp-cli locations --json

Agent-native plumbing

Agent原生适配

  • 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
    bash
    ufo-goat-pp-cli download --agency FBI --resume
  • download
     —— 支持断点续传、校验和进度追踪，用于下载2.3GB的归档文件
    仅PDF文件就占2.3GB——Agent需要可靠的批量下载及状态追踪功能
    bash
    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
  • ufo-goat-pp-cli files search
    — Full-text search across file titles, descriptions, and locations
agencies —— 为PURSUE发布内容做贡献的政府机构
  • ufo-goat-pp-cli agencies
    —— 列出所有贡献机构及其文件数量
files —— 来自FBI、国防部、NASA、国务院的解密UAP文件（PDF、视频、图片）
  • ufo-goat-pp-cli files get
    —— 获取特定文件的详细信息
  • ufo-goat-pp-cli files list
    —— 列出所有解密UAP文件
  • ufo-goat-pp-cli files search
    —— 对文件标题、描述和位置进行全文搜索

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
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.
当你知道要做什么但不确定对应命令时，可直接询问CLI：
bash
ufo-goat-pp-cli which "<用你自己的话描述功能>"
which
命令会将自然语言的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少找到一个匹配项；退出码
2
表示无匹配项——此时可改用
--help
或缩小查询范围。

Recipes

使用示例

Find all Moon incidents

查找所有月球事件

bash
ufo-goat-pp-cli files list --location Moon --json --select title,agency,incident_date
Surfaces Apollo-era lunar UAP observations from NASA files
bash
ufo-goat-pp-cli files list --location Moon --json --select title,agency,incident_date
展示NASA文件中阿波罗时代的月球UAP观测记录

Download all FBI files

下载所有FBI文件

bash
ufo-goat-pp-cli download --agency FBI --resume
Batch download with resume support for the 56 FBI contributions
bash
ufo-goat-pp-cli download --agency FBI --resume
批量下载FBI贡献的56份文件，支持断点续传

Cross-agency timeline for the 1960s

1960年代跨机构事件时间线

bash
ufo-goat-pp-cli timeline --after 1960 --before 1970 --agent
See incidents across all agencies during the peak UFO era
bash
ufo-goat-pp-cli timeline --after 1960 --before 1970 --agent
查看UFO事件高发期内所有机构的事件记录

Find video-document pairs

查找视频与文档配对文件

bash
ufo-goat-pp-cli pairs --json --select video_title,pdf_title,agency
Discover which videos have accompanying PDF reports
bash
ufo-goat-pp-cli pairs --json --select video_title,pdf_title,agency
发现哪些视频配有对应的PDF报告

Track new releases

追踪新发布内容

bash
ufo-goat-pp-cli sync && ufo-goat-pp-cli new
Fetch latest manifest and see what's been added since last check
bash
ufo-goat-pp-cli sync && ufo-goat-pp-cli new
获取最新清单并查看自上次检查以来新增的内容

Auth Setup

认证设置

No authentication required.
Run 
ufo-goat-pp-cli doctor
to verify setup.
无需认证。
执行
ufo-goat-pp-cli doctor
验证设置是否正确。

Agent Mode

Agent模式

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:
    bash
    ufo-goat-pp-cli agencies --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
在任何命令后添加
--agent
参数。该参数等效于：
--json --compact --no-input --no-color --yes
。
  • 可管道传输 —— 标准输出为JSON，错误信息输出到标准错误
  • 可过滤 —— 
    --select
    参数保留指定字段子集。点路径可深入嵌套结构；数组可遍历元素。这在处理冗长API时对缩小上下文范围至关重要：
    bash
    ufo-goat-pp-cli agencies --agent --select id,name,status
  • 可预览 —— 
    --dry-run
    参数显示请求内容但不发送
  • 离线友好 —— 同步/搜索命令在本地SQLite存储可用时可使用该存储
  • 非交互式 —— 从不弹出提示，所有输入均通过标志参数提供
  • 只读 —— 请勿使用本CLI执行创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他修改状态的请求

Response envelope

响应包结构

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "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 — piped/agent consumers get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包裹在来源信息包中：
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
获取数据，通过
.meta.source
判断数据来自在线还是本地。仅当标准输出为终端时，才会向标准错误输出人类可读的
N results (live)
摘要；管道传输/Agent消费时，标准输出仅为纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
ufo-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
ufo-goat-pp-cli feedback --stdin < notes.txt
ufo-goat-pp-cli feedback list --json --limit 10
Entries are stored locally at 
~/.ufo-goat-pp-cli/feedback.jsonl
. They are never POSTed unless 
UFO_FEEDBACK_ENDPOINT
is set AND either 
--send
is passed or 
UFO_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.
当你（或Agent）发现本CLI存在问题时，可记录反馈：
ufo-goat-pp-cli feedback "--since参数是包含性的，但文档说是排他性的"
ufo-goat-pp-cli feedback --stdin < notes.txt
ufo-goat-pp-cli feedback list --json --limit 10
反馈条目存储在本地
~/.ufo-goat-pp-cli/feedback.jsonl
文件中。除非设置了
UFO_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置
UFO_FEEDBACK_AUTO_SEND=true
，否则反馈不会被POST发送。默认仅存储在本地。
请记录令你感到意外的内容，而非正式的错误报告。简短、具体、单行描述：这样的反馈才更有价值。

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:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to 
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or 
application/x-ndjson
when 
--compact
)
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.
所有命令均支持
--deliver <sink>
参数。输出会发送到指定的sink，同时（或替代）输出到标准输出，因此Agent无需手动管道即可路由命令结果。支持三种sink：
Sink效果
stdout
默认值；仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
（先写入临时文件再重命名）
webhook:<url>
将输出体POST到指定URL（当使用
--compact
时为
application/json
或
application/x-ndjson
格式）
不支持的协议会返回结构化错误，并列出支持的类型。Webhook失败时返回非零退出码，并将URL和HTTP状态记录到标准错误。

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.
ufo-goat-pp-cli profile save briefing --json
ufo-goat-pp-cli --profile briefing agencies
ufo-goat-pp-cli profile list --json
ufo-goat-pp-cli profile show briefing
ufo-goat-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.
配置文件是一组保存的标志值，可在多次调用中复用。适用于定时Agent每次运行时使用相同配置调用同一命令的场景——即HeyGen的“Beacon”模式。
ufo-goat-pp-cli profile save briefing --json
ufo-goat-pp-cli --profile briefing agencies
ufo-goat-pp-cli profile list --json
ufo-goat-pp-cli profile show briefing
ufo-goat-pp-cli profile delete briefing --yes
显式标志始终优先于配置文件值；配置文件值优先于默认值。
agent-context
会在
available_profiles
下列出所有可用配置文件，因此自省Agent可在运行时发现这些配置文件。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误（参数错误）
3资源未找到
5API错误（上游问题）
7速率限制（请等待后重试）
10配置错误

Argument Parsing

参数解析

Parse 
$ARGUMENTS
:
  1. Empty, 
    help
    , or 
    --help
     → show 
    ufo-goat-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
    )
解析
$ARGUMENTS
的规则：
  1. 为空、
    help
    或
    --help
     → 显示
    ufo-goat-pp-cli --help
    输出
  2. 以
    install
    开头     → 如果结尾为
    mcp
    → 安装MCP；否则 → 参见顶部的前提条件部分
  3. 其他情况 → 直接使用（带
    --agent
    参数执行CLI命令）

MCP Server Installation

MCP服务器安装

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/other/ufo-goat/cmd/ufo-goat-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add ufo-goat-pp-mcp -- ufo-goat-pp-mcp
  3. Verify: 
    claude mcp list
  1. 安装MCP服务器：
    bash
    go install github.com/mvanhorn/printing-press-library/library/other/ufo-goat/cmd/ufo-goat-pp-mcp@latest
  2. 在Claude Code中注册：
    bash
    claude mcp add ufo-goat-pp-mcp -- ufo-goat-pp-mcp
  3. 验证安装：
    claude mcp list

Direct Use

直接使用

  1. Check if installed: 
    which ufo-goat-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:
    bash
    ufo-goat-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: 
    ufo-goat-pp-cli <command> --help
    .
  1. 检查是否已安装：
    which ufo-goat-pp-cli
    如果未找到，提供安装选项（参见顶部的前提条件部分）。
  2. 将用户查询与上述独特功能和命令参考中最匹配的命令对应。
  3. 带
    --agent
    参数执行命令：
    bash
    ufo-goat-pp-cli <command> [subcommand] [args] --agent
  4. 如果存在歧义，查看子命令帮助：
    ufo-goat-pp-cli <command> --help
    。