iaoxe CLI

Orquestación de coding de IAOXE en tu terminal y tu CI. Mismo motor que la app de escritorio: GLM-5.2 escribe el volumen, Claude revisa lo crítico, con control de costo. Sin dependencias (Node ≥ 18).

Instalación

npm install -g iaoxe-cli    # paquete: iaoxe-cli · comando: iaoxe
iaoxe help

Desde el repo (desarrollo):

cd iaoxe-cli
npm link                    # expone el comando `iaoxe`
# o directo: node bin/iaoxe.js <comando>

Dos modos

Gestionado (créditos IAOXE) — recomendado

iaoxe login      # abre Google en el navegador, guarda la sesión en ~/.iaoxe/session.json
iaoxe whoami     # muestra tu cuenta y créditos disponibles
iaoxe logout

Con sesión, los comandos usan los créditos IAOXE (sin gestionar claves): el CLI rutea al proxy gestionado, igual que la app de escritorio.

BYOK (tus propias claves)

Exporta las claves de proveedor, o ponlas en ~/.iaoxe/config.json, y usa --byok:

export ZAI_API_KEY=...         # GLM-5.2 (workhorse)
export ANTHROPIC_API_KEY=...   # Claude (review)
iaoxe run --byok "..."

{ "keys": { "ZAI_API_KEY": "...", "ANTHROPIC_API_KEY": "..." } }

Sin sesión y sin --byok, el CLI usa BYOK por defecto. Con sesión, usa créditos IAOXE salvo que pases --byok.

Comandos

iaoxe run "add a subtract() to math.js and document it"   # AGENTE: lee y edita archivos del repo
iaoxe run "..." --dry-run               # muestra qué editaría, sin escribir
iaoxe run "..." --print                 # solo imprime la respuesta (no edita)
iaoxe review                            # revisión crítica del diff (vs HEAD)
iaoxe review --staged                   # revisa lo que está en stage
iaoxe review --model claude-opus        # usa otro modelo de revisión
iaoxe models                            # lista los modelos
iaoxe help

run es un agente: lee archivos del repo y los edita (confinado al cwd). Trabaja mejor dentro de un repo git para revisar el diff (git diff / iaoxe review) y revertir si hace falta.

Revisión en CI

iaoxe review devuelve exit code 2 si el veredicto es block y 1 si pide cambios, así que puedes fallar un pipeline ante hallazgos críticos:

- run: iaoxe review --staged

Publicar (mantenedores)

npm login
npm publish --access public    # paquete: iaoxe-cli (npm bloquea "iaoxe" por similitud)

El paquete incluye lib/auth-config.js con la config client-public de IAOXE (Firebase API key + OAuth client de tipo Desktop), igual que la app de escritorio.

Estado

v1: login/whoami (créditos IAOXE), run agéntico (lee/edita archivos) y review (auto-review headless), en modo gestionado o BYOK.