AI Accounts Hub CLI

Standalone aah command for AI Accounts Hub. You can use it without installing the desktop app.

Install

npm install -g @murongg/aah-cli

The npm package has its own standalone CLI version and downloads the matching prebuilt native binary from the cli-vX.Y.Z GitHub Release during installation.

On macOS or Linux, you can install the standalone Release binary without npm:

curl -fsSL https://raw.githubusercontent.com/murongg/ai-accounts-hub/main/scripts/install-aah.sh | sh

Pin a version or install into another directory:

curl -fsSL https://raw.githubusercontent.com/murongg/ai-accounts-hub/main/scripts/install-aah.sh -o install-aah.sh
AAH_VERSION=0.1.3 sh install-aah.sh
AAH_INSTALL_DIR=/usr/local/bin sh install-aah.sh

Publishing from GitHub Actions requires the repository secret NPM_TOKEN to be an npm Automation token when the npm account has publish 2FA enabled. A regular publish token will fail with EOTP because CI cannot provide a one-time password.

Usage

Open the interactive TUI:

aah tui

TUI shortcuts:

• up/down or j/k: select account
• Enter: switch to the selected account
• r: refresh quota
• 1/2/3/a: filter Codex, Claude, Gemini, or all
• q or Esc: quit

Run script-friendly commands:

aah add --provider codex
aah add --provider codex --autofill --email [email protected]
aah list
aah current
aah refresh
aah upgrade
aah switch --provider codex [email protected]

aah add --provider ... starts the provider's login flow, stores the account in the managed account pool, and leaves the current active CLI account unchanged.

For Codex, the CLI can also use the browser autofill login flow:

aah add --provider codex --autofill --email [email protected]

The default mode prompts for the password with hidden terminal input. For scripts, pass the password through stdin so it does not land in shell history:

printf '%s\n' "$CODEX_PASSWORD" | aah add --provider codex --autofill --email [email protected] --password-stdin

Autofill login uses the official auth.openai.com flow and requires Chrome or Chromium on the machine. Verification codes, MFA, Passkeys, and risk checks still need to be completed manually in the browser. The password is used only for that login attempt and is not written to the account pool, logs, or export files.

aah upgrade checks the latest cli-vX.Y.Z release, auto-detects how the CLI was installed, and upgrades in place when safe. On older installs that do not have install metadata yet, it may print a one-line manual upgrade command instead of upgrading directly.

Filter by provider:

aah list --provider codex
aah current --provider claude
aah refresh --provider gemini

Use JSON output:

aah list --json
aah current --json

Relay Mode

If you need a local Codex-compatible endpoint, you can enable the built-in relay.

• The relay is off by default
• It currently serves Codex routes only
• It only binds to 127.0.0.1
• The default base URL is http://127.0.0.1:8765/codex
• The desktop app and CLI share the same running relay instance

Manage the local relay:

aah relay status
aah relay start --port 8765
aah relay stop
aah relay set-port 9876

• aah relay start [--port ...] persists enabled=true and makes sure the relay is running
• aah relay stop persists enabled=false and stops the current relay instance

Use a custom data directory:

aah --data-dir ~/.ai-accounts-hub list

By default, the CLI stores and reads managed account data from ~/.ai-accounts-hub. The desktop app uses the same directory, and startup migrates older desktop app data into this shared directory by default.

Relay settings are stored in ~/.ai-accounts-hub/settings.json. The shared relay runtime registry lives at ~/.ai-accounts-hub/relay/runtime.json. If you pass --data-dir, both paths move under that directory.