- ~/
Build on X, or run a client someone already open-sourced
itwtr is a plain-English developer guide to the X (Twitter) ecosystem: a curated list of open-source X clients you can install, and a step-by-step guide to building your own tool on the X API.
New here? Start with Getting started, or jump to the open-source clients if you just want something to install.
What you'll find
Open-source clients
Desktop, CLI and web clients with public source repos you can read, self-host and fork.
Browse clients →The build-your-own guide
From an API key to posting your first tweet from code: auth, endpoints, rate limits.
Open the guide →From the blog
What changed when X moved to API v2
The practical differences from v1.1: versioned endpoints, opt-in fields, and OAuth 2.0 PKCE, for anyone porting a client.
Building on the free tier without hitting a wall
What the X API free tier allows, the documented posting limits, and how to design a small tool that stays inside them.
Self-hosting an open-source X client
A checklist for running an open-source X client on your own machine: credentials, secrets, a reverse proxy, and staying current.