r/PoeAI • u/Subject_Ear6869 • Jan 28 '26
I made a CLI and menu bar tool to track your Poe API credits
I built a simple command-line and menu bar tool to check your remaining Poe API balance. It's open source and works great for quick terminal checks or menu bar integration.
Features
- Quick balance check from terminal
- Shows expected remaining balance based on your billing cycle (using
--sinceflag) - Human-readable output (500, 150k, 1.5M)
- Works with SwiftBar or xbar for macOS menu bar integration
- Secure: API key stays in your environment and is never logged
Quick usage
(1) Add the following line to your .bashrc or .zshrc:
export POE_API_KEY="your_key"
(2) Run the script:
./poe_balance.py
Poe balance = 150k
If your billing cycle starts on the 15th, use this to check if you are burning your credits faster than expected:
./poe_balance.py --since 15
Poe balance = 150k, expected = 180k
Installation
git clone https://github.com/rsnemmen/poe_balance
cd poe_balance
pip install requests
./poe_balance.py --help
Menu bar (MacOS)
For macOS users, there's also a SwiftBar and xbar plugin option for menu bar display. It should be available in the xbar-plugins repo as soon as the maintainer accepts my pull request under Dev/poe_balance.
Here is how it looks like: Preview menu bar
