@aipd/codex-cli (v0.2)

Companion CLI for the smartee Claude Code plugin.

Logs you into the AIPD platform with username + password, picks a project, and stores the resulting 90-day api-key in the OS keychain. The plugin reads it via the SMARTEE_KEY env var.

Install

cd smartee-cli
npm install && npm run build
npm link

Commands

| Command | Purpose | | --------------------------- | ------------------------------------------------------------------------------------------------- | | smartee login [-u email] | Prompt user + password → list projects → pick → store api-key | | smartee switch-project | Logout + login again to bind to a different project | | smartee rotate | Issue a fresh 90-day key (same user + project) before expiry | | smartee logout | Revoke + clear keychain | | smartee status | Show user, project, expiry, daysLeft (masked key) | | smartee set-mcp-url <url> | Override the MCP gateway URL | | smartee env | Print export SMARTEE_KEY=… lines — use with eval | | smartee onboard | Write SMARTEE_KEY + SMARTEE_MCP_URL into .claude/settings.local.json of the current project |

Daily workflow

smartee login
cd your-project
smartee onboard   # writes .claude/settings.local.json
claude

Legacy shell-export flow still works:

eval "$(smartee env)"
claude

Env vars

| Var | Default | Purpose | | --------------- | ----------------------- | ------------------------------- | | AIPD_API_BASE | http://localhost:3000 | Backend URL for /codex/auth/* |

Storage

| What | Where | | ------------------------ | ------------------------------------------------------------------------ | | API key | OS keychain (keytar) — macOS Keychain / libsecret / Win Credential Vault | | Fallback if keytar fails | ~/.smartee/api-key mode 0600 | | Project, expiry, mcpUrl | ~/.smartee/state.json mode 0600 |

The status command prints which backend is active.