@techsnif/cli

@techsnif/cli

Public CLI for TechSnif. Query story clusters, coverage links, social discussion, editorial articles, leaderboards, and tech events from the terminal, or stream stories live.

Install

npm install -g @techsnif/cli

Or run without installing:

npx @techsnif/cli --help

Commands

stories: list story clusters

techsnif stories
techsnif stories --sort newest --limit 10
techsnif stories --tier 3
techsnif stories --publisher "The Verge"
techsnif stories --platform x
techsnif stories --has-discussion
techsnif stories --platform bluesky --has-discussion --json

Option	Description
--limit <n>	Results to return (default 20, max 80)
--offset <n>	Skip this many results (pagination)
--sort <order>	rank (prominence, default) or newest
--tier <n>	Filter by headline tier: 1=standard, 2=major, 3=top
--publisher <name>	Filter by lead publisher name
--platform <name>	Only stories discussed on this platform (x, bluesky, threads, linkedin, forums, mastodon)
--has-discussion	Only stories with social discussion links
--since <date>	Only stories seen since this ISO date
--topic <slug>	Filter by topic slug (e.g. ai, security)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

story: full story cluster detail

techsnif story flipboard-launches-surf
techsnif story flipboard-launches-surf --platform x
techsnif story flipboard-launches-surf --publisher TechCrunch
techsnif story flipboard-launches-surf --brief
techsnif story flipboard-launches-surf --platform bluesky --open

Option	Description
--platform <name>	Filter discussion to this platform only
--publisher <name>	Filter coverage links by publisher name
--brief	Skip the full TechSnif article body, show metadata and links only
--open	Open URLs in browser (lead article, or filtered platform discussion URLs)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

search: search stories by headline keyword

techsnif search "AI funding"
techsnif search "robotics" --platform x
techsnif search "Apple" --publisher "The Verge" --limit 5 --json

Option	Description
--limit <n>	Results to return (default 10, max 50)
--offset <n>	Skip this many results (pagination)
--publisher <name>	Filter by lead publisher name
--platform <name>	Narrow displayed discussion links to this platform
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

timeline: ranking history of a story

Shows each snapshot of a story cluster over time: date, rank, tier, commentary count, and coverage count.

techsnif timeline flipboard-launches-surf
techsnif timeline flipboard-launches-surf --json

Option	Description
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

changes: stories added or updated since a timestamp

techsnif changes
techsnif changes --since 2026-08-17T00:00:00Z --limit 100
techsnif changes --json

Option	Description
--since <date>	ISO 8601 timestamp to read changes from (default 24 hours ago)
--limit <n>	Results to return (default 50, max 100)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

When more changes are available, the output includes the next --since cursor to continue from.

trending: stories or articles gaining momentum

techsnif trending
techsnif trending --hours 6 --limit 10
techsnif trending --type articles
techsnif trending --json

Option	Description
--type <type>	stories (default, ranked by velocity) or articles
--hours <n>	Look-back window for stories (default 24, max 48)
--limit <n>	Results to return (stories default 20 max 50, articles default 5 max 20)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

watch: stream stories live

Connects to the TechSnif SSE feed and prints each new or updated story as it arrives. Reconnects automatically with exponential backoff (up to 5 attempts), resuming from the last seen event.

techsnif watch
techsnif watch --topics ai --tier 2
techsnif watch --topics ai,crypto
techsnif watch --tier 3 --json

Option	Description
--topics <list>	Comma-separated topic slugs; a story must match at least one (e.g. ai,crypto)
--tier <n>	Minimum headline tier: 1=standard, 2=major, 3=top
--json	One JSON object per event (NDJSON) instead of one-line summaries
--api-url <url>	Override API base URL

Filters are applied server-side on the stream, so a filtered watch only receives matching events. Human output is one line per story: time, tier, headline, and URL. Active filters print on connect. Press Ctrl+C to stop.

events: upcoming tech events

techsnif events
techsnif events --limit 5 --json

Option	Description
--limit <n>	Results to return (default 10, max 50)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

articles: list TechSnif editorial articles

techsnif articles
techsnif articles --category AI --limit 5
techsnif articles --tag Security --json

Option	Description
--limit <n>	Results to return (default 10, max 50)
--offset <n>	Skip this many results (pagination)
--category <name>	Filter by category (AI, Startups, Venture, Robotics)
--tag <name>	Filter by tag (e.g. Security, Fintech, Open Source)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

articles search: full-text article search

techsnif articles search "open source funding"
techsnif articles search "chips" --limit 5 --json

Option	Description
--limit <n>	Results to return (default 20, max 50)
--offset <n>	Skip this many results (pagination)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

article: full article by slug

techsnif article anthropic-ships-claude-agents
techsnif article anthropic-ships-claude-agents --brief

Option	Description
--brief	Show metadata and excerpt only, skip the full body
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

leaderboard: source and author rankings

techsnif leaderboard
techsnif leaderboard --tab authors --window 7d
techsnif leaderboard --topic ai --limit 10 --json

Option	Description
--tab <tab>	Rank sources (default) or authors
--window <window>	Time window: 7d, 30d (default), or all
--topic <slug>	Filter by topic slug
--limit <n>	Results to return (default 50, max 100)
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

platforms: active discussion platforms

techsnif platforms
techsnif platforms --json

Lists social platforms with active discussion across current stories, with story counts.

Local Development

pnpm techsnif --help

Override the API host for local development or staging:

pnpm techsnif stories --api-url http://localhost:4321

You can also set TECHSNIF_API_URL to change the default API host for every command.

Requests include a non-identifying User-Agent header such as TechSnif-CLI/0.6.1 so TechSnif can distinguish CLI traffic from MCP and generic API traffic in aggregate Cloudflare analytics. The CLI does not send cookies, device IDs, or user identifiers.

JSON Output

Every command supports --json and returns a stable envelope:

{
  "ok": true,
  "data": {},
  "targetEnv": "https://api.techsnif.com"
}

The watch command is the exception: with --json it emits one JSON object per stream event (NDJSON).

Notes

• The public CLI is intentionally API-only, with no direct database access.
• Command defaults are generated from the shared agent contract, so the CLI, the MCP server, and the hosted MCP expose the same defaults.
• Internal/operator workflows remain repo-local and are not part of the published package.
• Platform and publisher filtering is case-insensitive throughout.
• --open caps at 5 URLs to prevent tab overload.