Talon for Mac

Connect X safely.

Talon talks directly to X from your Mac. You control the developer app, prepaid credits, spending limit, and OAuth credentials.

01 · Requirements

Know the boundaries first.

The current Talon build requires macOS 14 or later on Apple Silicon. X requires an approved developer account, a Project and App, and user-context OAuth access for private bookmarks.

02 · X developer app

Register the exact native callback.

In the X Developer Console, create a Native App using OAuth 2.0 with PKCE. Add this callback URL exactly:

talon://oauth/x

Enable tweet.read, users.read, bookmark.read, bookmark.write, and offline.access. Talon never requests access to your likes. With this native callback, X returns the result directly to the app and the Talon website is not involved in the authorization flow.

03 · X API credits

Prepay only what you choose.

X uses prepaid, pay-per-use API credits. Its published Owned Reads rate is currently $0.001 per owned bookmark resource when you own both the X account and developer app. Other post, user, folder, write, or enrichment requests can have different prices.

Set a spending limit Add a small credit balance and configure a spending limit in the X Developer Console. X controls and may change pricing, eligibility, limits, and availability.

04 · Connect Talon

Authorize from the Mac app.

In Talon, open Settings → Connections, paste the X Client ID, and choose Connect with X OAuth. Complete authorization in the browser, return to Talon, then run Quick Sync. Client secrets are optional for X Native Apps; any supplied credentials are stored in Keychain.

05 · Optional AI

AI is optional.

Local organization, reading, export, and exact search work without AI. Ask, summaries, and automatic labels can use your OpenAI/OpenRouter/xAI key, Ollama or another local compatible endpoint, or supported Codex/Grok subscription sign-ins. Those provider costs and limits remain under your control.