@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

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.