Lightweight CLI for managing Factory Droid API keys with auto-rotation.
dk manages multiple Factory Droid API keys in one place. It tracks usage limits and expiration dates, and automatically rotates to the next available key when one runs out—so your AI coding sessions never get interrupted.
- Heavy Droid Users — Manage multiple API keys without manual switching
- Team Environments — Share key pools across machines
- Uninterrupted Workflows — Auto-rotation keeps sessions running
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/notdp/oroio/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/notdp/oroio/main/install.ps1 | iexThe installer adds a droid function to your shell. Restart your terminal, then just run droid.
# 1. Add your API keys
dk add fk-xxxx fk-yyyy fk-zzzz
# Or import from file (one key per line)
dk add --file keys.txt
# 2. Check usage and expiration
dk list
# 3. Run droid (auto-injects key, auto-rotates on exhaustion)
droidHere's what dk list looks like:
| Command | Description |
|---|---|
dk add <key...> |
Add one or more API keys |
dk add --file <path> |
Import keys from file |
dk list |
Show all keys with usage/expiration |
dk current |
Display current key and copy export command |
dk use <n> |
Switch to key by index |
dk rm <n...> |
Remove keys by index |
dk run <cmd> |
Run command with current key (auto-rotates) |
dk serve |
Start web dashboard on port 7758 |
dk config |
Configure CLI options (border style, etc.) |
dk reinstall |
Update to latest version |
dk uninstall |
Remove dk |
dk serve # Start dashboard
dk serve stop # Stop dashboard
dk serve status # Check if runningAccess at http://localhost:7758 to view and manage keys visually.
A standalone desktop app is available for macOS, Windows, and Linux. It provides the same dashboard experience with system tray integration and low-balance notifications.
Download from Releases.
macOS: After installing, run
xattr -cr /Applications/oroio.appto bypass Gatekeeper (app is unsigned).Note: The desktop app works standalone for key management. To use
droidin terminal, install the CLI separately.
macOS / Linux:
- Binary:
~/.local/bin/dk - Data:
~/.oroio/ - Shell alias:
droid→dk run droid
Windows:
- Script:
%LOCALAPPDATA%\oroio\bin\dk.ps1 - Data:
%USERPROFILE%\.oroio\ - PowerShell function:
droid→dk run droid
dk reinstallOr manually:
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/notdp/oroio/main/reinstall.sh | bash# Windows
irm https://raw.githubusercontent.com/notdp/oroio/main/reinstall.ps1 | iexdk uninstallOr manually:
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/notdp/oroio/main/uninstall.sh | bash# Windows
irm https://raw.githubusercontent.com/notdp/oroio/main/uninstall.ps1 | iexStop juggling API keys. Start shipping code.