@techsnif/cli

@techsnif/cli

Public CLI for TechSnif — query story clusters, coverage links, social discussion, and tech events from the terminal.

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)
--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
--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 by headline keyword

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

Option	Description
--limit <n>	Results to return (default 10, max 50)
--publisher <name>	Filter by lead publisher name
--platform <name>	Only stories discussed on this platform
--has-discussion	Only stories with social discussion links
--json	Machine-readable JSON output
--api-url <url>	Override API base URL

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

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.4.2 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"
}

Notes

• The public CLI is intentionally API-only — no direct database access.
• 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.