Skip to main content
The octolens CLI brings your Octolens workspace to the terminal: the mentions Octolens collects for you across Reddit, X, LinkedIn, Hacker News and the rest, plus the keywords, feeds, filters, notifications and analytics around them. It is built for two kinds of user at once:
  • People at a terminal — skim new mentions over coffee, open one in the browser, mark the false positives, watch a launch unfold live.
  • Agents and scripts — every command takes --json and emits exactly one JSON document on stdout, errors are a single machine-readable envelope on stderr, and exit codes are stable. If you are wiring the CLI into CI or an agent, read The —json contract and Exit codes first.

​
What it feels like

Search on demand — one-time, AI-scored, no setup first (new workspaces can be created from the terminal too — Signup & the Agents plan):
Triage a mention — inspect it, then correct the AI’s relevance call:
Watch your mentions live during a launch, narrowed to one source:
Export a filtered slice to CSV for a spreadsheet or a report:

​
Where to start

Quickstart

Your first ten minutes: log in, initialize the workspace, read and triage your first mentions.

Install & login

npm install, the browser login, API keys for CI, and what each scope allows.

Initialize a workspace

The guided onboarding: company profile, keywords, filters and your first feed — all from the terminal.

Command reference

The full command set, group by group, exactly as the binary states it.
Scripting against the CLI? The contract pages — the —json contract, exit codes, the error envelope and global flags — hold for every command on this site.