npm - codex-account-orchestrator - Versions diffs - 1.2.0 → 1.4.0 - Mend

codex-account-orchestrator 1.2.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.4.0] - 2026-01-27
+### Added
+- `cao status --pretty` dashboard view (TTY default)
+- `cao status --doctor` and `cao status --report` consolidated flags
+### Changed
+- `cao status` now defaults to a dashboard in TTY and compact output otherwise
+- `cao doctor` and `cao report` are deprecated (status flags preferred)
+- `cao list --details` removed in favor of `cao status`
+- Added Chinese and Spanish README translations
+## [1.3.0] - 2026-01-27
+### Added
+- `cao doctor` health checks with JSON output and exit codes
+- `cao report` for Markdown/JSON shareable account summaries
+- Interactive account switching (`cao switch`) and `cao current` convenience command
+- Optional `cao run --gateway` to route traffic through the gateway without CLI fallback
+- `cao status --pretty` for a framed dashboard view
+### Changed
+- README emphasizes CAO’s unique observability and reporting features
+- Added Korean and Japanese README translations
+- Added Chinese and Spanish README translations
 ## [1.2.0] - 2026-01-27
 ### Added

package/README.es.md ADDED Viewed

@@ -0,0 +1,162 @@
+# codex-account-orchestrator (CAO)
+[![CI](https://github.com/DAWNCR0W/codex-account-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/DAWNCR0W/codex-account-orchestrator/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/codex-account-orchestrator.svg)](https://www.npmjs.com/package/codex-account-orchestrator)
+[![npm downloads](https://img.shields.io/npm/dm/codex-account-orchestrator.svg)](https://www.npmjs.com/package/codex-account-orchestrator)
+[![license](https://img.shields.io/npm/l/codex-account-orchestrator.svg)](LICENSE)
+[![node](https://img.shields.io/node/v/codex-account-orchestrator.svg)](https://nodejs.org/)
+[![typescript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+Orquestador de cuentas OAuth de Codex. CAO mantiene un `CODEX_HOME` separado por cuenta y cambia automáticamente a la siguiente cuenta cuando se agota la cuota.
+Language: [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md) | Español
+## Por qué CAO
+- Fallback automático cuando se agota la cuota
+- Modo gateway sin cortar la sesión
+- Resúmenes de estado y health checks
+- Reportes en Markdown o JSON
+- Aislamiento por cuenta
+## Requisitos
+- Node.js 18+
+- Codex CLI instalado y disponible en `PATH`
+## Instalación
+```bash
+npm install -g codex-account-orchestrator
+```
+El CLI está disponible como `cao` o `codex-account-orchestrator`.
+## Inicio rápido
+1. Agregar cuentas
+```bash
+cao add accountA
+cao add accountB
+```
+2. Seleccionar cuenta por defecto
+```bash
+cao switch
+```
+3. Ejecutar con fallback
+```bash
+cao run
+```
+Para pasar argumentos a Codex, colócalos después de `--`:
+```bash
+cao run -- exec "summarize README"
+```
+## Comandos principales
+| Comando | Descripción |
+| --- | --- |
+| `cao add <name>` | Agregar cuenta e iniciar sesión |
+| `cao switch` | Cambio interactivo |
+| `cao current` | Cuenta por defecto actual |
+| `cao list` | Lista rápida de cuentas |
+| `cao status` | Dashboard en TTY o resumen compacto |
+| `cao status --full` | Estado completo (verbose) |
+| `cao status --compact` | Resumen en una línea |
+| `cao status --doctor` | Health checks |
+| `cao status --report [md|json]` | Reporte en Markdown/JSON |
+| `cao run` | Ejecutar con fallback |
+| `cao run --gateway` | Ejecutar vía gateway |
+## Observabilidad
+```bash
+cao status                 # Dashboard en TTY, resumen si no
+cao status --full          # Salida completa (verbose)
+cao status --compact       # Resumen en una línea
+cao status --pretty        # Forzar dashboard
+```
+Health checks (0=ok, 1=warn, 2=error):
+```bash
+cao status --doctor
+cao status --doctor --json
+```
+Reportes:
+```bash
+cao status --report        # Reporte Markdown
+cao status --report json   # Reporte JSON
+```
+## Modo Gateway (sin cortar sesión)
+Iniciar gateway:
+```bash
+cao gateway start
+```
+Ejecutar vía gateway (fallback del CLI desactivado):
+```bash
+cao run --gateway
+```
+## Cómo funciona
+Cada cuenta vive en su propio directorio:
+```text
+~/.codex-account-orchestrator/<account>/
+```
+Se crea un `config.toml` por cuenta:
+```toml
+cli_auth_credentials_store = "file"
+forced_login_method = "chatgpt"
+```
+## Estructura de datos
+```text
+~/.codex-account-orchestrator/
+  registry.json
+  account_status.json
+  <account>/auth.json
+  <account>/config.toml
+```
+## Importar snapshots (opcional)
+```bash
+cao import codex-auth
+cao import codex-auth --source ~/.codex/accounts
+cao import codex-auth --overwrite
+```
+## Desarrollo
+```bash
+npm install
+npm run test
+```
+## Notas
+- El fallback captura salida y puede hacer que Codex detecte un stdout no TTY. Usa `--no-fallback` si necesitas TTY puro.
+- El detector de cuota es por palabras clave y se puede ampliar en `src/constants.ts`.
+## Changelog
+Consulta `CHANGELOG.md`.

package/README.ja.md ADDED Viewed

@@ -0,0 +1,157 @@
+# codex-account-orchestrator (CAO)
+[![CI](https://github.com/DAWNCR0W/codex-account-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/DAWNCR0W/codex-account-orchestrator/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/codex-account-orchestrator.svg)](https://www.npmjs.com/package/codex-account-orchestrator)
+[![npm downloads](https://img.shields.io/npm/dm/codex-account-orchestrator.svg)](https://www.npmjs.com/package/codex-account-orchestrator)
+[![license](https://img.shields.io/npm/l/codex-account-orchestrator.svg)](LICENSE)
+[![node](https://img.shields.io/node/v/codex-account-orchestrator.svg)](https://nodejs.org/)
+[![typescript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+Codex OAuth アカウントのオーケストレーター。CAO はアカウントごとに `CODEX_HOME` を分離し、クォータ消費時に自動で次のアカウントへ切り替えます。
+Language: [English](README.md) | [한국어](README.ko.md) | 日本語 | [中文](README.zh.md) | [Español](README.es.md)
+## CAO の特徴
+- クォータ枯渇時の自動フォールバック
+- セッションを切らさないゲートウェイモード
+- 状態サマリーとヘルスチェック
+- 共有可能なレポート出力
+- アカウントごとの完全分離
+## 必要条件
+- Node.js 18+
+- Codex CLI が PATH にあること
+## インストール
+```bash
+npm install -g codex-account-orchestrator
+```
+CLI は `cao` または `codex-account-orchestrator` で実行できます。
+## クイックスタート
+1. アカウント追加
+```bash
+cao add accountA
+cao add accountB
+```
+2. デフォルト切り替え
+```bash
+cao switch
+```
+3. フォールバック実行
+```bash
+cao run
+```
+Codex 引数は `--` の後に渡します:
+```bash
+cao run -- exec "summarize README"
+```
+## 主要コマンド
+| コマンド | 説明 |
+| --- | --- |
+| `cao add <name>` | アカウント追加とログイン |
+| `cao switch` | 対話式で切り替え |
+| `cao current` | 現在のデフォルトを表示 |
+| `cao list` | アカウント一覧 (簡易) |
+| `cao status` | ステータスダッシュボード (TTY) または簡易サマリー |
+| `cao status --full` | 詳細フル出力 |
+| `cao status --compact` | 1 行サマリー |
+| `cao status --doctor` | ヘルスチェック |
+| `cao status --report [md|json]` | レポート出力 |
+| `cao run` | フォールバック実行 |
+| `cao run --gateway` | ゲートウェイ経由 |
+## 可視化
+```bash
+cao status                 # TTYならダッシュボード、それ以外はサマリー
+cao status --full          # 詳細フル出力
+cao status --compact       # 1 行サマリー
+cao status --pretty        # ダッシュボード強制
+```
+ヘルスチェック (0=ok, 1=warn, 2=error):
+```bash
+cao status --doctor
+cao status --doctor --json
+```
+レポート:
+```bash
+cao status --report        # Markdown レポート
+cao status --report json   # JSON レポート
+```
+## ゲートウェイモード
+ゲートウェイはセッションを維持したまま切り替えます。
+```bash
+cao gateway start
+cao run --gateway
+```
+## 仕組み
+アカウントごとのディレクトリ:
+```text
+~/.codex-account-orchestrator/<account>/
+```
+`config.toml` は各アカウントごとに作成されます:
+```toml
+cli_auth_credentials_store = "file"
+forced_login_method = "chatgpt"
+```
+## データ配置
+```text
+~/.codex-account-orchestrator/
+  registry.json
+  account_status.json
+  <account>/auth.json
+  <account>/config.toml
+```
+## スナップショット取り込み (任意)
+```bash
+cao import codex-auth
+cao import codex-auth --source ~/.codex/accounts
+cao import codex-auth --overwrite
+```
+## 開発
+```bash
+npm install
+npm run test
+```
+## ノート
+- フォールバックは出力をキャプチャするため、TTY ではないと見なされる場合があります。必要なら `--no-fallback` を使ってください。
+- クォータ検出はキーワードベースで、`src/constants.ts` で拡張できます。
+## 変更履歴
+`CHANGELOG.md` を参照してください。

package/README.ko.md ADDED Viewed

@@ -0,0 +1,157 @@
+# codex-account-orchestrator (CAO)
+[![CI](https://github.com/DAWNCR0W/codex-account-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/DAWNCR0W/codex-account-orchestrator/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/codex-account-orchestrator.svg)](https://www.npmjs.com/package/codex-account-orchestrator)
+[![npm downloads](https://img.shields.io/npm/dm/codex-account-orchestrator.svg)](https://www.npmjs.com/package/codex-account-orchestrator)
+[![license](https://img.shields.io/npm/l/codex-account-orchestrator.svg)](LICENSE)
+[![node](https://img.shields.io/node/v/codex-account-orchestrator.svg)](https://nodejs.org/)
+[![typescript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+Codex OAuth 계정 오케스트레이터. CAO는 계정마다 별도의 `CODEX_HOME`을 만들고, 쿼터가 소진되면 자동으로 다음 계정으로 전환합니다.
+Language: [English](README.md) | 한국어 | [日本語](README.ja.md) | [中文](README.zh.md) | [Español](README.es.md)
+## CAO의 강점
+- 쿼터 소진 시 자동 폴백
+- 세션이 끊기지 않는 게이트웨이 모드
+- 상태 요약과 헬스체크
+- 공유 가능한 보고서 출력
+- 계정별 완전 격리
+## 요구 사항
+- Node.js 18+
+- Codex CLI 설치 및 PATH 등록
+## 설치
+```bash
+npm install -g codex-account-orchestrator
+```
+CLI는 `cao` 또는 `codex-account-orchestrator`로 실행합니다.
+## 빠른 시작
+1. 계정 추가
+```bash
+cao add accountA
+cao add accountB
+```
+2. 기본 계정 선택
+```bash
+cao switch
+```
+3. 폴백 실행
+```bash
+cao run
+```
+Codex 인자를 넘길 때는 `--` 뒤에 넣습니다:
+```bash
+cao run -- exec "summarize README"
+```
+## 주요 명령어
+| 명령어 | 설명 |
+| --- | --- |
+| `cao add <name>` | 계정 추가 및 로그인 |
+| `cao switch` | 대화형 계정 전환 |
+| `cao current` | 현재 기본 계정 표시 |
+| `cao list` | 계정 목록 (간단) |
+| `cao status` | 상태 대시보드 (TTY) 또는 간단 요약 |
+| `cao status --full` | 상세 전체 출력 |
+| `cao status --compact` | 한 줄 요약 |
+| `cao status --doctor` | 헬스체크 및 종료 코드 |
+| `cao status --report [md|json]` | 보고서 생성 |
+| `cao run` | 폴백 실행 |
+| `cao run --gateway` | 게이트웨이 경유 |
+## 관측성
+```bash
+cao status                 # TTY에서는 대시보드, 그 외에는 요약
+cao status --full          # 상세 전체 출력
+cao status --compact       # 한 줄 요약
+cao status --pretty        # 대시보드 강제
+```
+헬스체크 (0=ok, 1=warn, 2=error):
+```bash
+cao status --doctor
+cao status --doctor --json
+```
+보고서:
+```bash
+cao status --report        # Markdown 보고서
+cao status --report json   # JSON 보고서
+```
+## 게이트웨이 모드
+게이트웨이는 세션을 유지한 채 계정을 전환합니다.
+```bash
+cao gateway start
+cao run --gateway
+```
+## 동작 방식
+계정별 디렉터리 구조:
+```text
+~/.codex-account-orchestrator/<account>/
+```
+`config.toml`은 계정마다 생성됩니다:
+```toml
+cli_auth_credentials_store = "file"
+forced_login_method = "chatgpt"
+```
+## 데이터 레이아웃
+```text
+~/.codex-account-orchestrator/
+  registry.json
+  account_status.json
+  <account>/auth.json
+  <account>/config.toml
+```
+## 스냅샷 가져오기 (선택)
+```bash
+cao import codex-auth
+cao import codex-auth --source ~/.codex/accounts
+cao import codex-auth --overwrite
+```
+## 개발
+```bash
+npm install
+npm run test
+```
+## 참고
+- 폴백 모드는 출력 캡처로 인해 TTY가 아닌 것처럼 보일 수 있습니다. 순수 TTY가 필요하면 `--no-fallback`을 사용하세요.
+- 쿼터 감지는 키워드 기반이며 `src/constants.ts`에서 확장할 수 있습니다.
+## 변경 이력
+`CHANGELOG.md`를 참고하세요.