@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.