Back to Details

pp-wanderlust-goat

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Wanderlust GOAT — Printing Press CLI

Wanderlust GOAT — Printing Press CLI

Prerequisites: Install the CLI

前置条件：安装CLI

This skill drives the 
wanderlust-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 wanderlust-goat --cli-only
  2. Verify: 
    wanderlust-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/travel/wanderlust-goat/cmd/wanderlust-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.
Most 'near me' tools return the 40 closest results. Wanderlust GOAT returns the 3 results that match your stated identity and criteria. It fuses Nominatim, OSRM walking time, OSM Overpass, Wikipedia, Wikivoyage, Atlas Obscura, Reddit, editorial scrapes (Eater, Time Out, NYT 36 Hours, Michelin), and language-aware regional sources (Tabelog, Naver, Le Fooding) through one trust-weighted score, with local-language names preserved alongside transliterations. Free, no API keys, with an offline SQLite store and a JSON 
research-plan
surface for agent orchestration.
本技能基于
wanderlust-goat-pp-cli
二进制文件运行。在调用本技能的任何命令之前，你必须确认CLI已安装。如果未安装，请先执行以下步骤：
  1. 通过Printing Press安装器安装：
    bash
    npx -y @mvanhorn/printing-press install wanderlust-goat --cli-only
  2. 验证安装：
    wanderlust-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/travel/wanderlust-goat/cmd/wanderlust-goat-pp-cli@latest
如果安装后执行
--version
提示“command not found”，说明安装程序未将二进制文件添加到
$PATH
中。在验证成功前，请不要执行技能相关命令。
大多数“附近推荐”工具会返回40个最近的结果，而Wanderlust GOAT只会返回3个符合你身份和条件的结果。它通过一个信任加权评分系统，融合了Nominatim、OSRM步行时间、OSM Overpass、Wikipedia、Wikivoyage、Atlas Obscura、Reddit、编辑类爬虫内容（Eater、Time Out、NYT 36 Hours、Michelin）以及语言感知的区域数据源（Tabelog、Naver、Le Fooding），同时保留地点的本地语言名称及音译。该工具免费使用，无需API密钥，支持离线SQLite存储，并提供用于Agent编排的JSON格式
research-plan
接口。

When to Use This CLI

何时使用本CLI

Reach for wanderlust-goat when you need persona-shaped place discovery within walking distance, especially for cross-cultural travel where English search dominates and the local-language gems are hidden. Best for trip prep (sync-city), in-the-moment 'what should I walk to from here' (near, goat), photographer routing (golden-hour, route-view), and agent-orchestrated travel research (research-plan). Prefer Mapbox/Google MCPs only if you have their keys and need raw geocoding without persona scoring.
当你需要基于特定身份发现步行可达的地点时，尤其是在英语搜索占主导、本地特色宝藏被隐藏的跨文化旅行场景中，选择Wanderlust GOAT准没错。它最适合旅行准备（sync-city）、即时场景下的“从这里步行能去什么地方”（near、goat命令）、摄影师路线规划（golden-hour、route-view命令）以及Agent编排的旅行研究（research-plan命令）。只有当你拥有Mapbox/Google MCP密钥，且仅需要原始地理编码而无需身份匹配评分时，才考虑使用这些平台。

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.
以下功能是其他同类工具所不具备的：

Persona-shaped fanout

基于身份的多源筛选

  • near
     — Find the 3-5 amazing things within walking distance that match your stated identity and criteria — not the 40 closest things.
    When an agent needs the curated picks for a persona at a location, this is the single command that fuses ~12 sources into one ranked, sourced answer.
    bash
    wanderlust-goat-pp-cli near "Park Hyatt Tokyo" --criteria "vintage jazz kissaten, no tourists, great pour-over" --identity "coffee snob, into 70s Japanese kissaten culture" --minutes 15 --agent
  • goat
     — Same fanout as 
    near
    but with no LLM in the runtime path — criteria-to-source mapping uses static lookup tables so the CLI works standalone.
    Agents and humans both need a GOAT mode that works without an LLM caller — useful for shell pipelines, cron, and offline runs.
    bash
    wanderlust-goat-pp-cli goat "35.6895,139.6917" --criteria "vintage clothing, vinyl, hidden" --minutes 20 --agent
  • near
     — 在步行范围内找到3-5个符合你身份和条件的绝佳地点，而非40个最近的地点。
    当Agent需要为特定身份的用户在某个地点提供精选推荐时，这个命令能将约12个数据源融合为一个带排名和来源的答案。
    bash
    wanderlust-goat-pp-cli near "Park Hyatt Tokyo" --criteria "vintage jazz kissaten, no tourists, great pour-over" --identity "coffee snob, into 70s Japanese kissaten culture" --minutes 15 --agent
  • goat
     — 功能与
    near
    相同，但运行时无需LLM——条件与数据源的映射使用静态查找表，因此CLI可独立运行。
    Agent和用户都需要无需LLM调用的GOAT模式，这在shell管道、定时任务和离线运行场景中非常实用。
    bash
    wanderlust-goat-pp-cli goat "35.6895,139.6917" --criteria "vintage clothing, vinyl, hidden" --minutes 20 --agent

Agent-orchestration plumbing

Agent编排接口

  • research-plan
     — Output a JSON query plan agents execute in a loop — typed, country-aware, ordered by trust, ready to fan out.
    Drop this into an agent loop to let the agent run multi-source travel research without re-deriving the fanout plan every call.
    bash
    wanderlust-goat-pp-cli research-plan "Bukchon Hanok Village, Seoul" --criteria "hand-pulled noodles, locals only" --identity "food traveler" --json
  • research-plan
     — 输出Agent可循环执行的JSON查询计划，该计划支持类型定义、适配不同国家、按信任度排序，可直接用于多源分发。
    将此计划接入Agent循环，可让Agent执行多源旅行研究，无需每次调用都重新生成分发计划。
    bash
    wanderlust-goat-pp-cli research-plan "Bukchon Hanok Village, Seoul" --criteria "hand-pulled noodles, locals only" --identity "food traveler" --json

Cross-source walks

跨源步行路线

  • crossover
     — Find pairs where a high-trust restaurant sits within 200m of a Wikipedia-notable historic site or Atlas Obscura entry — food + culture in one walk.
    When the persona wants 'a great meal next to something interesting', this is the spatial query that compounds two layers.
    bash
    wanderlust-goat-pp-cli crossover --anchor "Marais, Paris" --radius 800m --pair food+culture --agent
  • golden-hour
     — Compute sunrise/sunset/blue-hour locally (pure Go, no API) and pair with viewpoints photographers know about within walking distance.
    When an agent needs to brief Felix the photographer for tonight's shoot, this is the one call that fuses the math and the spots.
    bash
    wanderlust-goat-pp-cli golden-hour "Eiffel Tower" --date 2026-06-15 --minutes 20 --agent
  • route-view
     — Walking polyline from A to B, then everything interesting along the path — not just at the endpoints.
    For walks where the journey IS the point, the agent needs everything along the path — not the closest thing to either end.
    bash
    wanderlust-goat-pp-cli route-view "Shibuya Station, Tokyo" "Yoyogi Park, Tokyo" --buffer 150m --agent
  • quiet-hour
     — Places that locals describe as quiet at the requested time, intersected with OSM opening hours and walking radius.
    Agents helping someone find the un-crowded version of a popular cafe need the Reddit-quiet-signal layer the persona always asks for but never gets.
    bash
    wanderlust-goat-pp-cli quiet-hour "Yurakucho, Tokyo" --minutes 15 --day mon --time 14:00 --agent
  • crossover
     — 查找高可信度餐厅与维基百科收录的历史遗迹或Atlas Obscura条目相距200米以内的组合，实现美食+文化的一站式步行体验。
    当用户想要“在有趣的地方附近享用美食”时，这个空间查询能将两个维度的内容结合起来。
    bash
    wanderlust-goat-pp-cli crossover --anchor "Marais, Paris" --radius 800m --pair food+culture --agent
  • golden-hour
     — 本地计算日出/日落/蓝调时刻（纯Go实现，无需API），并匹配步行范围内摄影师熟知的观景地点。
    当Agent需要为摄影师Felix准备今晚拍摄的简报时，这个命令能将时间计算和地点推荐融合在一起。
    bash
    wanderlust-goat-pp-cli golden-hour "Eiffel Tower" --date 2026-06-15 --minutes 20 --agent
  • route-view
     — 生成从A到B的步行路线折线，并展示沿途所有有趣的地点，而不仅仅是终点。
    对于注重旅途体验的步行路线，Agent需要了解沿途的所有内容，而非仅终点附近的地点。
    bash
    wanderlust-goat-pp-cli route-view "Shibuya Station, Tokyo" "Yoyogi Park, Tokyo" --buffer 150m --agent
  • quiet-hour
     — 查找当地人描述在指定时段较为安静的地点，并结合OSM营业时间和步行范围进行筛选。
    当Agent帮助用户寻找热门咖啡馆的人少时段版本时，需要用户经常提及但其他工具无法提供的Reddit安静信号维度。
    bash
    wanderlust-goat-pp-cli quiet-hour "Yurakucho, Tokyo" --minutes 15 --day mon --time 14:00 --agent

Local store + sync

本地存储与同步

  • sync-city
     — Pre-cache editorial best-of, Reddit threads, Wikipedia, Wikivoyage, OSM POIs, Atlas Obscura, and regional-language sources for offline use.
    Agents working offline or with flaky connectivity need a synced local store; this populates it.
    bash
    wanderlust-goat-pp-cli sync-city tokyo --layers all --agent
  • why
     — Print every source that mentioned a place, the trust weight, country boost, walking time, criteria match, and the final goat-score breakdown.
    When the agent's pick surprises the user, this command answers 'why was this ranked #1?' in one call.
    bash
    wanderlust-goat-pp-cli why "珈琲 美美" --json
  • reddit-quotes
     — Surface the highest-scored Reddit comment snippets that mention a place — verbatim quotes, no LLM summarization.
    Agents giving travel advice need the actual local quotes, not a summary that can hallucinate. This returns the raw text with provenance.
    bash
    wanderlust-goat-pp-cli reddit-quotes "Kohi Bibi" --json
  • coverage
     — Per-tier row counts, last-sync ages, country-match boost, and which v1 sources are missing for a synced city.
    Before an agent trusts a 
    near
    answer, it should check whether the local store actually has the layers it claims to fuse.
    bash
    wanderlust-goat-pp-cli coverage tokyo --json
  • sync-city
     — 预缓存编辑类精选内容、Reddit帖子、Wikipedia、Wikivoyage、OSM兴趣点、Atlas Obscura以及区域语言数据源，以供离线使用。
    在离线或网络不稳定环境下工作的Agent需要同步的本地存储，这个命令可完成数据填充。
    bash
    wanderlust-goat-pp-cli sync-city tokyo --layers all --agent
  • why
     — 打印提及某个地点的所有数据源、信任权重、国家增益、步行时间、条件匹配度以及最终的goat评分明细。
    当Agent的推荐让用户感到意外时，这个命令能一次性回答“为什么这个地点排名第一？”
    bash
    wanderlust-goat-pp-cli why "珈琲 美美" --json
  • reddit-quotes
     — 展示提及某个地点的最高评分Reddit评论片段，保留原文引用，不经过LLM总结。
    Agent提供旅行建议时需要真实的本地评论，而非可能产生幻觉的总结内容。该命令返回带有来源的原始文本。
    bash
    wanderlust-goat-pp-cli reddit-quotes "Kohi Bibi" --json
  • coverage
     — 显示已同步城市的各层级数据行数、最后同步时间、国家匹配增益以及缺失的v1数据源。
    在Agent信任
    near
    命令的结果之前，应检查本地存储是否真的包含其声称融合的所有数据源。
    bash
    wanderlust-goat-pp-cli coverage tokyo --json

Command Reference

命令参考

places — Geocode addresses and look up canonical place coordinates via Nominatim (foundation layer for the multi-source GOAT stack).
  • wanderlust-goat-pp-cli places reverse
    — Reverse geocode lat/lng to a structured address.
  • wanderlust-goat-pp-cli places search
    — Forward geocode an address, place name, or business to lat/lng candidates.
places — 通过Nominatim进行地址地理编码并查找标准地点坐标（这是多源GOAT栈的基础层）。
  • wanderlust-goat-pp-cli places reverse
    — 将经纬度反向地理编码为结构化地址。
  • wanderlust-goat-pp-cli places search
    — 将地址、地点名称或商家名称正向地理编码为经纬度候选结果。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
wanderlust-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
wanderlust-goat-pp-cli which "<用你自己的话描述功能>"
which
命令会将自然语言的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少有一个匹配项；退出码
2
表示没有明确匹配项——此时可使用
--help
或缩小查询范围。

Recipes

使用示例

Kissaten hunt in Tokyo (Mira's morning)

东京咖啡馆搜寻（Mira的早晨行程）

bash
wanderlust-goat-pp-cli near "Park Hyatt Tokyo" --criteria "vintage jazz kissaten, no tourists, great pour-over" --identity "coffee snob, into 70s Japanese kissaten culture" --minutes 15 --agent --select results.name,results.name_local,results.why_special,results.sources,results.walking_min
Returns 3-5 picks with local-language names preserved (e.g. 珈琲 美美), trust-weighted across Tabelog 3.5+, jp.wikipedia history, /r/japan threads, Time Out Tokyo's vintage-cafe list, and OSM 
cafe + cuisine=japanese
tagging. The dotted --select narrows the JSON to the fields the persona cares about so an agent doesn't burn context on raw payload.
bash
wanderlust-goat-pp-cli near "Park Hyatt Tokyo" --criteria "vintage jazz kissaten, no tourists, great pour-over" --identity "coffee snob, into 70s Japanese kissaten culture" --minutes 15 --agent --select results.name,results.name_local,results.why_special,results.sources,results.walking_min
返回3-5个推荐结果，保留本地语言名称（如“珈琲 美美”），评分基于Tabelog 3.5+评分、日语维基百科历史记录、/r/japan帖子、Time Out Tokyo的复古咖啡馆列表以及OSM的
cafe + cuisine=japanese
标签。
--select
参数可将JSON结果缩小到用户关心的字段，避免Agent在原始 payload上浪费上下文。

Photographer's blue-hour route in Seoul (Felix's evening)

首尔摄影师蓝调时刻路线（Felix的晚间行程）

bash
wanderlust-goat-pp-cli golden-hour "Bukchon Hanok Village, Seoul" --date 2026-06-15 --minutes 25 --agent
Computes blue-hour and golden-hour windows for the date locally (no API), then ranks viewpoints from OSM 
tourism=viewpoint
+ Atlas Obscura viewpoint entries + ko.wikipedia notable-views by elevation tag and Reddit-accessibility keyword match. Agent can plan the walk in one call.
bash
wanderlust-goat-pp-cli golden-hour "Bukchon Hanok Village, Seoul" --date 2026-06-15 --minutes 25 --agent
本地计算指定日期的蓝调时刻和黄金时刻窗口（无需API），然后根据海拔标签和Reddit可达性关键词匹配度，对OSM的
tourism=viewpoint
节点、Atlas Obscura观景条目以及韩语维基百科收录的著名观景地点进行排名。Agent可通过一次调用完成路线规划。

Agent-orchestrated research plan for a friend's Paris weekend

为朋友的巴黎周末制定Agent编排研究计划

bash
wanderlust-goat-pp-cli research-plan "Marais, Paris" --criteria "natural wine, neighborhood spot, no scene" --identity "food writer" --json
Emits typed JSON describing which clients to call (Le Fooding, Pudlo, fr.wikivoyage, /r/Paris, Eater Paris, Michelin Bib Gourmand) with parameters pre-filled. Drop into an agent loop: agent executes each, then you call 
near
with 
--data-source local
to fuse the cached results.
bash
wanderlust-goat-pp-cli research-plan "Marais, Paris" --criteria "natural wine, neighborhood spot, no scene" --identity "food writer" --json
输出类型化JSON，描述需要调用的客户端（Le Fooding、Pudlo、法语维基旅游、/r/Paris、Eater Paris、米其林必比登）及预填充参数。将此计划接入Agent循环：Agent执行每个查询，然后你可以使用
--data-source local
参数调用
near
命令融合缓存结果。

Crossover walk: a great meal next to something interesting

跨界步行：美食+有趣地点的组合

bash
wanderlust-goat-pp-cli crossover --anchor "Asakusa, Tokyo" --radius 800m --pair food+culture --agent --csv
Spatial join finds high-trust restaurants within 200m of a Wikipedia-notable historic site or Atlas Obscura entry. CSV output lets you paste pairs into a planning doc; --agent forces structured exit codes for cron scripts.
bash
wanderlust-goat-pp-cli crossover --anchor "Asakusa, Tokyo" --radius 800m --pair food+culture --agent --csv
通过空间关联查找距离维基百科收录的历史遗迹或Atlas Obscura条目200米以内的高可信度餐厅。CSV输出可直接粘贴到规划文档中；
--agent
参数会强制生成结构化退出码，适用于定时任务脚本。

Pre-trip city sync (Priya's two-weeks-out workflow)

旅行前城市数据同步（Priya的两周准备流程）

bash
wanderlust-goat-pp-cli sync-city paris --layers all --concurrency 2 --since 30d
Polite-rate-limited fanout: editorial scrapes + multilingual Wikipedia + Wikivoyage + OSM Overpass POIs + Le Fooding + Pudlo + /r/Paris top threads ≥10 upvotes, all into local SQLite. After this, every other command can run with 
--data-source local
(or 
auto
) — no internet needed in the cafe with bad wifi.
bash
wanderlust-goat-pp-cli sync-city paris --layers all --concurrency 2 --since 30d
采用礼貌的速率限制分发：缓存编辑类爬虫内容、多语言维基百科、维基旅游、OSM Overpass兴趣点、Le Fooding、Pudlo以及/r/Paris中点赞数≥10的热门帖子，所有数据存储到本地SQLite。完成同步后，其他所有命令都可以使用
--data-source local
（或
auto
）参数运行——即使在wifi信号差的咖啡馆也无需联网。

Auth Setup

认证设置

No API keys. Every v1 source is free and key-less.
One environment variable matters: Nominatim's usage policy requires every client to send a User-Agent that includes a real contact URL or email — placeholder UAs (
example.com
) are blocked at the edge. Set it once:
bash
export WANDERLUST_GOAT_UA="wanderlust-goat-pp-cli/0.1 (+https://github.com/<you>/<repo>)"
If unset, the CLI falls back to a generic UA that may receive 403s from Nominatim. The same UA flows through to Wikipedia, Wikivoyage, Reddit, and Overpass — being a polite citizen across the public stack.
Run 
wanderlust-goat-pp-cli doctor
to verify setup.
无需API密钥。所有v1数据源均免费且无需密钥。
有一个环境变量需要注意：Nominatim的使用政策要求每个客户端发送包含真实联系URL或邮箱的User-Agent，占位符UA（如
example.com
）会被边缘节点拦截。只需设置一次：
bash
export WANDERLUST_GOAT_UA="wanderlust-goat-pp-cli/0.1 (+https://github.com/<you>/<repo>)"
如果未设置，CLI会回退到通用UA，可能会被Nominatim返回403错误。该UA也会用于Wikipedia、Wikivoyage、Reddit和Overpass——做公共数据源的友好使用者。
执行
wanderlust-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
    wanderlust-goat-pp-cli places search --query example-value --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
    参数保留字段子集。点路径可深入嵌套结构；数组会遍历每个元素。这对于在 verbose API中缩小上下文至关重要：
    bash
    wanderlust-goat-pp-cli places search --query example-value --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:
wanderlust-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
wanderlust-goat-pp-cli feedback --stdin < notes.txt
wanderlust-goat-pp-cli feedback list --json --limit 10
Entries are stored locally at 
~/.wanderlust-goat-pp-cli/feedback.jsonl
. They are never POSTed unless 
WANDERLUST_GOAT_FEEDBACK_ENDPOINT
is set AND either 
--send
is passed or 
WANDERLUST_GOAT_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存在问题时，可以记录反馈：
wanderlust-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
wanderlust-goat-pp-cli feedback --stdin < notes.txt
wanderlust-goat-pp-cli feedback list --json --limit 10
反馈条目存储在本地
~/.wanderlust-goat-pp-cli/feedback.jsonl
文件中。仅当设置了
WANDERLUST_GOAT_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置了
WANDERLUST_GOAT_FEEDBACK_AUTO_SEND=true
时，反馈才会被POST发送。默认行为仅存储在本地。
请写下让你感到意外的点，而非正式的bug报告。简短、具体、单行描述：这样的反馈才最有价值。

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（
application/json
格式，使用
--compact
时为
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.
wanderlust-goat-pp-cli profile save briefing --json
wanderlust-goat-pp-cli --profile briefing places search --query example-value
wanderlust-goat-pp-cli profile list --json
wanderlust-goat-pp-cli profile show briefing
wanderlust-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”模式。
wanderlust-goat-pp-cli profile save briefing --json
wanderlust-goat-pp-cli --profile briefing places search --query example-value
wanderlust-goat-pp-cli profile list --json
wanderlust-goat-pp-cli profile show briefing
wanderlust-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 
    wanderlust-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
     → 显示
    wanderlust-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/travel/wanderlust-goat/cmd/wanderlust-goat-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add wanderlust-goat-pp-mcp -- wanderlust-goat-pp-mcp
  3. Verify: 
    claude mcp list
  1. 安装MCP服务器：
    bash
    go install github.com/mvanhorn/printing-press-library/library/travel/wanderlust-goat/cmd/wanderlust-goat-pp-mcp@latest
  2. 在Claude Code中注册：
    bash
    claude mcp add wanderlust-goat-pp-mcp -- wanderlust-goat-pp-mcp
  3. 验证安装：
    claude mcp list

Direct Use

直接使用

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