Pp Techtwitter

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/social-and-messaging/techtwitter/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/". -->

Tech Twitter — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the techtwitter-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. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

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

2. Verify: techtwitter-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/techtwitter/cmd/techtwitter-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Tech Twitter curates, dedupes, summarizes, and quality-scores the high-signal slice of tech X. This CLI turns that into a local SQLite mirror you can full-text search offline, and adds commands that only a compounding store can answer: what changed since your last sync, topic momentum over time, emerging narratives, time travel to any past day, and offline cited evidence bundles for agents.

When to Use This CLI

Use this CLI when an agent or user needs cited, structured evidence from Tech Twitter's curated tech-discourse corpus, when you want offline full-text search over a deduped quality-scored stream instead of the raw X firehose, or when the question is about change over time (what's new, what's gaining momentum, what narrative is emerging) that a single stateless API call cannot answer.

Anti-triggers

Do not use this CLI for:

• Posting, liking, bookmarking, or otherwise writing to X/Twitter — this CLI is read-only over Tech Twitter's curated corpus, not an X client.
• Fetching arbitrary tweets straight from X — only tweets Tech Twitter has curated are available.
• Account, billing, sponsor, or submission flows on techtwitter.com — those are auth-gated and out of scope.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• since — See only the tweets curated or newly hot since your last sync, instead of re-reading the whole stream.

  Reach for this to answer "what did I miss" without re-fetching or re-scanning the full corpus.

  techtwitter-pp-cli since 24h --agent

• momentum — Show which topics are rising, falling, or newly appearing across the heatmap snapshots stored on each sync.

  Use this when the question is about change over time, which no single API call can answer.

  techtwitter-pp-cli momentum --window 7d --json

• narrative — Surface keywords that newly emerged or accelerated versus prior snapshots, grounded in supporting stored tweets.

  Pick this over a one-shot narrative pull when you want what is newly emerging, not just what is currently large.

  techtwitter-pp-cli narrative --json

• author-rank — Rank authors by accumulated stored engagement over a window, each with their best curated tweet.

  Use this for a leaderboard that compounds as you sync, not the API's one-shot day winner.

  techtwitter-pp-cli author-rank --window 7d --limit 10 --json

• time-travel — Show the curated tweets for a specific date (YYYY-MM-DD, today, yesterday, or latest), live or fully offline from the local store.

  Use this to pull the snapshot of what tech Twitter was saying on a given day, with no live call once synced.

  techtwitter-pp-cli time-travel 2026-06-07 --limit 10 --json

Agent-native evidence, offline

• digest — Assemble a read-list from the local store for a window: top tweets, recent articles, and top authors.

  Reach for this to hand an agent a cited, single-shot "what's happening in tech" rollup with zero extra calls.

  techtwitter-pp-cli digest --window 24h --agent

• evidence — Build an evidence bundle mirroring the agent-context kinds from local SQLite, with canonical-URL citations and no network.

  Use this when an agent needs cited evidence but you want it grounded in the local mirror with no upstream call.

  techtwitter-pp-cli evidence read-list --agent --select evidence.title,evidence.canonicalUrl

Command Reference

agent — Machine-agent evidence bundles

• techtwitter-pp-cli agent — Cited evidence bundle for an agent question

articles — Long-form articles backed by tweet provenance

• techtwitter-pp-cli articles — List long-form articles

command — Command-center signals (hot takes, main character, heatmap, stats, by-date)

• techtwitter-pp-cli command heatmap — Topic momentum heatmap (keyword, count, engagement)
• techtwitter-pp-cli command hot-takes — High-reply, debate-heavy curated tweets
• techtwitter-pp-cli command main-character — The day's most-engaged authors (main character)
• techtwitter-pp-cli command stats — Corpus index health stats
• techtwitter-pp-cli command tweets-by-date — Curated tweets for a date (today, yesterday, latest, or YYYY-MM-DD)

newsletters — In-app newsletters (Threads)

• techtwitter-pp-cli newsletters — List published in-app newsletters

profiles — Curated author profiles

• techtwitter-pp-cli profiles — Search author profiles by name, handle, or bio

tweets — Search and browse the curated tweet stream

• techtwitter-pp-cli tweets author — Curated tweets for a specific author handle
• techtwitter-pp-cli tweets get — Get a single curated tweet by UUID (with prev/next neighbors)
• techtwitter-pp-cli tweets latest — Get the single most recent curated tweet (with nextTweetId)
• techtwitter-pp-cli tweets monthly — Curated tweets for a given month
• techtwitter-pp-cli tweets search — Search curated tweets by text (relevance-ranked)
• techtwitter-pp-cli tweets topic — Curated tweets for a topic slug
• techtwitter-pp-cli tweets trending — Ranked trending curated tweets from the last 7 days

Finding the right command

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

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

Cited what-changed evidence for an agent

techtwitter-pp-cli agent --kind what-changed --agent --select evidence.title,evidence.canonicalUrl,evidence.qualityScore

Pulls a cited evidence bundle and narrows the deeply nested response to just title, citation URL, and quality score so an agent isn't flooded with media and metric fields.