Is it made for AI agents?

Yes. Every command has --json, errors go to stderr as one JSON line, and exit codes are stable (3 not signed in, 4 plan required, 6 limit, 7 network). Coding agents such as Claude Code and Codex can run it directly.

Which plan do I need?

The CLI requires Pro or Maxi, like API tokens. On Free you can sign in, and whoami and usage work; reading commands answer with an upgrade message and exit code 4.

How does sign-in work?

toopost login opens the browser and uses OAuth Authorization Code with PKCE and a loopback redirect on 127.0.0.1, so no secret is typed into the terminal. The token is stored in ~/.config/toopost/credentials.json with mode 0600, lasts 90 days and renews while in use.

How do I use it in CI or on a server without a browser?

Create an API token with All permissions in Connections → API and set TOOPOST_TOKEN. It takes precedence over the saved login. On a remote shell you can also run toopost login --no-browser and open the printed URL yourself.

Can it talk to staging?

Yes: --api-url staging is a shortcut for https://api-staging.toopost.us. The default API is https://go.toopost.us.

Your sources in the terminal

toopost is a command-line client for your Toopost inbox: feed, full text, search, AI answers with citations, saved posts and sources, with JSON output for scripts and coding agents.

npx toopost login
toopost feed --since 24h

Create an account View on npm

Updated October 12, 2026 · facts mirror the app

toopost CLI

npm package toopost. Node 18.18 or newer, no runtime dependencies. Every command has --json; errors go to stderr with stable exit codes (3 = not signed in, 4 = plan, 6 = limit).

Install and sign in

npx toopost login          # opens the browser, approve "Toopost CLI"
toopost whoami
toopost feed --since 24h

Headless agents and CI

export TOOPOST_TOKEN=...   # API token with All permissions
toopost feed --json --since 6h | jq '.items[] | .title'

toopost feed	Posts from your sources, newest first. --since 24h, --source, --folder, --unread, --search, --limit
toopost read <id>	One post with its full text. --fetch downloads the page when the text is missing
toopost search <query>	Full-text search. Quotes, -exclude, site:host and dates like "last week"
toopost ask "<question>"	AI answer over your sources, streamed, with numbered citations
toopost saved · save <id> · unsave <id>	Saved posts
toopost sources · sources add <url> · sources remove <id>	Follow a site, feed, Telegram, YouTube or Reddit channel
toopost usage · whoami	Plan, AI usage percent and reset date

CLI FAQ

What is the toopost CLI?: An npm package (toopost) that reads your Toopost inbox from the terminal: feed, full text, search, AI answers with citations, saved posts and sources. It needs Node 18.18 or newer and has no runtime dependencies.
Is it made for AI agents?: Yes. Every command has --json, errors go to stderr as one JSON line, and exit codes are stable (3 not signed in, 4 plan required, 6 limit, 7 network). Coding agents such as Claude Code and Codex can run it directly.
Which plan do I need?: The CLI requires Pro or Maxi, like API tokens. On Free you can sign in, and whoami and usage work; reading commands answer with an upgrade message and exit code 4.
How does sign-in work?: toopost login opens the browser and uses OAuth Authorization Code with PKCE and a loopback redirect on 127.0.0.1, so no secret is typed into the terminal. The token is stored in ~/.config/toopost/credentials.json with mode 0600, lasts 90 days and renews while in use.
How do I use it in CI or on a server without a browser?: Create an API token with All permissions in Connections → API and set TOOPOST_TOKEN. It takes precedence over the saved login. On a remote shell you can also run toopost login --no-browser and open the printed URL yourself.
Can it talk to staging?: Yes: --api-url staging is a shortcut for https://api-staging.toopost.us. The default API is https://go.toopost.us.

Compare Pro and Maxi MCP for Claude and ChatGPT