pp-digg

name	pp-digg
description	Tail Digg's news cycle, GitHub feeds, and pipeline events from the terminal — read-only, with rank-history nobody else surfaces. Trigger phrases: `what's trending on Digg`, `digg top stories`, `digg github stars`, `digg github recent`, `what climbed the AI news rankings`, `digg leaderboard`, `what got replaced on Digg`, `tail the Digg pipeline`, `use digg`, `run digg-pp-cli`.
author	Matt Van Horn
license	Apache-2.0
argument-hint	<command> [args] | install cli|mcp
allowed-tools	Read Bash
metadata	{"openclaw":{"requires":{"bins":["digg-pp-cli"]}}}

Digg — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the digg-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 digg --cli-only
   

2. Verify: digg-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.3 or newer):

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/digg/cmd/digg-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.

When to Use This CLI

Use this CLI when an agent or power user needs structured access to Digg's rankings, ranking-change history, pipeline events, per-cluster transparency record, or the GitHub feeds. It is the right tool for tracking AI-news cycle movement, building cross-aggregator research over HN+Techmeme+Digg, watching new AI repos the moment they're starred by tracked accounts, or exposing Digg signals into a larger automation. Do NOT use it for vote, comment, or post automation — those mutations are explicitly out of scope.

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.

Topic search and per-post citations

• search — Topic search across Digg's full window. Live by default — hits /api/search/stories, the same server-side search that backs the di.gg/ai Cmd+K modal — with FTS5 fallback to the local store on network error or --data-source local.

  Returns ranked clusters with engagement metadata (postCount, uniqueAuthors, firstPostAge); the load-bearing recipe for last30days-style research workflows.

  digg-pp-cli search "<topic>" --since 30d --agent --select clusterUrlId,title,rank,postCount,uniqueAuthors,firstPostAge
  

  • --since Nh|Nd|Nw|Nm — filter to clusters first posted within the window (live mode parses Digg's own firstPostAge; local mode reads digg_clusters.first_post_at).

• posts — X posts attached to one cluster, with author rank, body when rendered, media URLs, repost-context, and minted xUrl for one-click citation.

  The citations recipe: surface the highest-credibility AI 1000 voices on a story, sortable by rank, type, or time.

  digg-pp-cli posts <clusterUrlId> --by rank --limit 5 --agent --select author.username,author.rank,post_type,xUrl,body
  

Author lookup and roster browse

• authors get — Look up any X handle in Digg's full author universe (1000 + off-1000) via /api/search/users. For off-1000 handles, the response includes subject_peer_follow_count, the rank-1000 anchor's peer_follow_count, and a signed peer_follow_gap — the gap to the 1000 measured in AI-1000 peer follows (NOT raw X follower count).

  The credibility lookup: an agent can decide whether to quote a handle by reading one structured record.

  digg-pp-cli authors get <handle> --agent
  

  Trimmed off-1000 example for mvanhorn:

  {
    "username": "mvanhorn",
    "current_rank": null,
    "subject_peer_follow_count": 19,
    "nearest_in_1000": {"rank": 1000, "username": "...", "peer_follow_count": 90},
    "peer_follow_gap": 71
  }
  

  peer_follow_gap is the gap to rank-1000's followed_by_count (peer follows from inside the AI 1000). Do not read it as a raw X follower delta.

• authors list — Full ranked AI 1000 from /ai/1000, persisted with rich fields (rank, category, bio, vibeDistribution, GitHub URL).

  Identify rising voices in a category, find authors who just joined the 1000, see who's falling fast — sortable, filterable, scriptable.

  # Biggest movers since the last snapshot
  digg-pp-cli authors list --by rankChange --limit 20 --agent
  
  # Newly listed (first appearance in the 1000)
  digg-pp-cli authors list --only-new --agent
  

  Sort with --by rank|rankChange|category|followers; filter with --category "<name>", --only-new, --only-fallers.

Live pipeline observability

• events — Tail Digg's ingestion pipeline in real time — see clusters as they're detected, stories fast-climbing the leaderboard with explicit rank deltas, X posts being processed, batch breakdowns.

  When an agent needs 'tell me when story X just climbed N ranks' or 'what new clusters did Digg detect in the last hour', this is the only way.

  digg-pp-cli events --since 1h --type fast_climb --json --select clusterId,label,delta,currentRank,previousRank
  

• watch — Poll /ai, diff against last snapshot, alert when any cluster moves N+ ranks.

  Read-only operational watcher; never writes anything back to Digg.

  digg-pp-cli watch --alert 'rank.delta>=10'
  

• pipeline status — One-screen view of /api/trending/status: isFetching, nextFetchAt, storiesToday, clustersToday, last 5 events.

  Lets ops and power users see when a fresh batch is about to land and what's been ingested in the last hour.

  digg-pp-cli pipeline status --watch
  

Local state that compounds

• replaced — Show stories that were knocked out of the rankings since the last sync, with Digg's own published replacement rationale.

  Best-of-feed shifts faster than people remember. This makes 'what did Digg drop and why' queryable.

  digg-pp-cli replaced --since 24h --json
  

• crossref — Show this cluster's Hacker News and Techmeme mirrors when Digg has detected the story is being discussed there.

  Removes the manual 'is HN talking about this too' step from any cross-aggregator research workflow.

  digg-pp-cli crossref iq7usf9e
  

• authors top — Top accounts Digg tracks, ranked by Digg's influence score, story count, or reach.

  Investors and AI scouts care which accounts move the news cycle. Now queryable, sortable, scriptable.

  digg-pp-cli authors top --by influence --limit 50 --json
  

• history — Full trajectory of one cluster's currentRank, peakRank, and delta over local snapshot history.

  'Entered at #18, peaked at #4 over 6h, dropped to #22 by 24h' is impossible to learn from the live site.

  digg-pp-cli history iq7usf9e --json
  

• author — Every cluster a given X account contributed to, with post type (original, retweet, quote, reply).

  'Show me every story this account surfaced this week' is the investor-scout query.

  digg-pp-cli author Scobleizer --since 7d --json
  

Transparency

• evidence — Print the full ranking transparency record for one cluster — scoreComponents, evidence array, numeratorLabel, percentAboveAverage.

  When a user asks 'why is THIS the top story', the answer is structured data; agents can compose with it.

  digg-pp-cli evidence iq7usf9e --json
  

• sentiment — Read per-time-window positivity ratios (pos6h, pos12h, pos24h, posLast) for a cluster.

  Tells an agent whether the conversation around a story is still net-positive or has soured; useful before quoting a story.

  digg-pp-cli sentiment iq7usf9e --window 6h --json
  

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Command Reference

feed — Top-level AI story feed (HTML page; CLI parses the embedded RSC stream)

• digg-pp-cli feed raw — Fetch the raw /ai HTML page. The CLI's sync command parses this; most users should run sync then top instead of...
• digg-pp-cli feed story_raw — Fetch the raw /ai/{clusterUrlId} story detail page (HTML). The CLI's story command parses this; users should not...

github — GitHub feeds Digg surfaces alongside the X-account leaderboard

• digg-pp-cli github stars — Top AI repos ranked by starring activity from Digg-tracked accounts. Returns repo_full_name, language, stargazers_count, recent starrers, breakout/novel/ai_related scores, and the model's one-sentence classification. Flags: --limit, --min-starrers N (keep only repos with >= N distinct starrers — smart-money convergence; applied BEFORE --limit).
• digg-pp-cli github new — Recently first-seen repos with the Digg-tracked creator/starrer who first put them on Digg's radar (event_id, event_created_at, repo_full_name, creator). Flag: --limit.
• digg-pp-cli github activity — Top GitHub contributor leaderboard: per-author rank, contribution count, and distinct repos count over Digg's tracking window. Flag: --limit.
• digg-pp-cli github recent — Live activity feed: per-event entries with the GitHub URL and the user who acted. Flag: --limit.

rankings — Sub-views of the /ai/x/rankings/companies snapshot

• digg-pp-cli rankings emerging — Curated list of small AI companies (the "EMERGING STARTUPS — CURATED THIS SNAPSHOT" section). ~10 rows per snapshot. Each row carries isEmergingStartup (AI-judge verdict) and emergingReasoning (curator text). Flag: --max-skip-ratio (schema-drift tolerance; default 0.10).
• digg-pp-cli rankings movers — Companies whose follower count shifted most since the last snapshot. Flags: --direction up|down|both (default both; direction stamped per row), --max-skip-ratio.
• digg-pp-cli rankings list — Full company ranking (the "Companies followed by the AI 2K" section). Server-paginated; returns the initial-HTML slice. Flags: --limit, --max-skip-ratio.

search — Topic search across the full Digg window

• digg-pp-cli search "<query>" — Live by default (/api/search/stories); FTS5 fallback to the local store. Flags: --since Nh|Nd|Nw|Nm, --data-source live|local|auto, --limit.

authors — Inspect Digg's tracked AI-news accounts (the /ai/1000 roster)

• digg-pp-cli authors get <handle> — Look up any X handle (1000 + off-1000); off-1000 records include subject_peer_follow_count, nearest_in_1000 anchor, and peer_follow_gap. Flag: --limit (fuzzy fallback).
• digg-pp-cli authors list — Full ranked roster from /ai/1000, persisted with rich fields. Flags: --by rank|rankChange|category|followers, --category, --only-new, --only-fallers, --limit.
• digg-pp-cli authors top — Top contributors by influence, post count, or reach. Flags: --by, --limit.

posts — X posts attached to one cluster

• digg-pp-cli posts <clusterUrlId> — Origins, replies, quotes, retweets with author rank, body when rendered, media URLs, minted xUrl. Flags: --by rank|type|time, --type tweet|reply|quote|retweet, --limit, --no-cache.

story — Full cluster detail. Envelope now includes posts and postsMeta fields populated by the U5 RSC parser.

trending — Public ingestion-pipeline status and event stream

• digg-pp-cli trending — Read the current pipeline status: storiesToday, clustersToday, isFetching, nextFetchAt, and the recent event stream...

Finding the right command

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

digg-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

Topic search for research workflows

digg-pp-cli search "<topic>" --since 30d --agent --select clusterUrlId,title,rank,postCount,uniqueAuthors,firstPostAge

Server-side search across Digg's full window via /api/search/stories; returns ranked clusters with engagement metadata (postCount, uniqueAuthors, firstPostAge). The load-bearing recipe for last30days-style consumers — pair with posts for citations.

Author credibility lookup (in or out of the 1000)

digg-pp-cli authors get <handle> --agent

Resolves any X handle to a structured record. For an off-1000 handle like mvanhorn, the response includes subject_peer_follow_count: 19, nearest_in_1000.peer_follow_count: 90, and peer_follow_gap: 71. peer_follow_gap is the distance to rank-1000 measured in AI-1000 peer follows (the metric Digg actually ranks by) — NOT a raw X follower-count delta.

Roster browse: biggest movers and newly listed

# Biggest movers since the last snapshot
digg-pp-cli authors list --by rankChange --limit 20 --agent

# Newly listed (first appearance in the 1000)
digg-pp-cli authors list --only-new --agent

Identify rising voices in a category, find authors who just joined the 1000. Sort with --by rank|rankChange|category|followers; filter with --category, --only-new, --only-fallers.

Top comments per article (citations)

digg-pp-cli posts <clusterUrlId> --by rank --limit 5 --agent --select author.username,author.rank,post_type,xUrl,body

Surfaces the highest-credibility AI 1000 voices on a story; minted X URLs make citations one-click. Combine with search to go from topic → cluster → quotable posts in two commands.

What climbed >=10 ranks in the last hour

digg-pp-cli events --since 1h --type fast_climb --json --select clusterId,label,delta,currentRank,previousRank

Reads the public events stream, filters to fast-climb events only, and narrows the JSON to the five fields an agent actually needs.

Why is a story the top story

digg-pp-cli evidence 65idu2x5 --json

Print the scoreComponents and evidence array for one cluster. Get a clusterUrlId from digg-pp-cli top --json --select clusterUrlId.

Show every cluster a given X account contributed to this week

digg-pp-cli author Scobleizer --since 7d --json --select label,clusterUrlId,activityAt

Queries the local store for clusters where the named author was a contributor; output is narrowed for agent consumption.

Cross-reference a story across HN and Techmeme

digg-pp-cli crossref 65idu2x5

Uses Digg's own hackerNews/techmeme reference fields so you don't have to search those sites manually. Pass any clusterUrlId from top --json --select clusterUrlId.

Tail the pipeline live

digg-pp-cli pipeline status --watch

One-screen dashboard of isFetching, nextFetchAt, storiesToday, clustersToday, and the last few pipeline events.

Auth Setup

No authentication required.

Run digg-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:

  digg-pp-cli feed raw --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 — piped/agent consumers get pure JSON on stdout.

Agent Feedback

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

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

Entries are stored locally at ~/.digg-pp-cli/feedback.jsonl. They are never POSTed unless DIGG_FEEDBACK_ENDPOINT is set AND either --send is passed or DIGG_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:

Sink	Effect
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.

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.

digg-pp-cli profile save briefing --json
digg-pp-cli --profile briefing feed raw
digg-pp-cli profile list --json
digg-pp-cli profile show briefing
digg-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

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

Argument Parsing

Parse $ARGUMENTS:

1. Empty, help, or --help → show digg-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 digg-pp-mcp -- digg-pp-mcp

Verify: claude mcp list

Direct Use

1. Check if installed: which digg-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:

   digg-pp-cli <command> [subcommand] [args] --agent
   

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