oroio

Lightweight CLI for managing Factory Droid API keys with auto-rotation.

中文

What is dk?

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.

Perfect For

• Heavy Droid Users — Manage multiple API keys without manual switching
• Team Environments — Share key pools across machines
• Uninterrupted Workflows — Auto-rotation keeps sessions running

Quick Start

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/notdp/oroio/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/notdp/oroio/main/install.ps1 | iex

The installer adds a droid function to your shell. Restart your terminal, then just run droid.

Basic Workflow

# 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)
droid

Here's what dk list looks like:

Commands

| 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 |

Web Dashboard

dk serve        # Start dashboard
dk serve stop   # Stop dashboard
dk serve status # Check if running

Access at http://localhost:7758 to view and manage keys visually.

Desktop App (Optional)

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.app to bypass Gatekeeper (app is unsigned).

Note: The desktop app works standalone for key management. To use droid in terminal, install the CLI separately.

Installation Details

What Gets Installed

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

Updating

dk reinstall

Or 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 | iex

Uninstalling

dk uninstall

Or 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 | iex

---

Stop juggling API keys. Start shipping code.