Access Your Twitter Feed From the Terminal with Antigravity Kit
Let's be honest: as developers, we spend a lot of time in our terminals. It's our home base. So when a tool comes along that brings something we use daily—like Twitter—right into that environment, it's worth a look. Antigravity Kit does exactly that, letting you scroll your timeline and check your bookmarks without ever leaving the command line.
It's a clever little project that turns your terminal into a lightweight Twitter client. No more constant tab-switching or getting lost in the algorithmic feed when you just want to quickly catch up.
What It Does
Antigravity Kit is a terminal-based client for X (formerly Twitter). It connects to the platform's API to fetch your authenticated feed—the tweets from the people you follow—and displays them in a clean, readable format right in your terminal window. You can also access your saved bookmarks, making it a handy tool for revisiting those links or tweets you set aside for later.
Why It's Cool
The beauty of this tool is in its simplicity and focus. It's not trying to replicate the full Twitter experience with media uploads or endless scrolling. Instead, it pares things down to the core text-based interaction many of us originally loved about the platform.
The implementation is straightforward and developer-friendly. It uses the Twitter API v2, and the terminal interface is built with textual, a Python framework for creating TUI (Text User Interface) apps. This means the codebase is approachable if you want to see how it works or even contribute. It's a focused tool that does one job well: delivering your timeline in a distraction-free zone.
How to Try It
Getting started requires a few steps, mainly because you need to authenticate with the Twitter API.
-
Clone the repo:
git clone https://github.com/vudovn/antigravity-kit.git cd antigravity-kit -
Set up API credentials: You'll need to create a project and get your API keys (Bearer Token) from the Twitter Developer Portal. Once you have them, copy the
.env.examplefile to.envand fill in your token. -
Install and run: The project uses Poetry for dependency management.
poetry install poetry run python -m antigravity_kit
For full details, including troubleshooting, check out the README on GitHub.
Final Thoughts
Antigravity Kit is a neat example of bringing a common web service back to the text-based roots many developers prefer. It's perfect for a quick check-in during a compile or while you're SSH'd into a server. It won't replace your main client for engaging deeply, but as a low-friction, focused reading pane, it's a great addition to the terminal toolbox. If you live in your terminal and use Twitter/X, it's definitely worth a few minutes to set up.
Follow for more cool projects: @githubprojects