@auroraflow/code
v0.0.12
Published
Aurora launcher and sidecar for official Codex and Claude Code clients.
Readme
Aurora Code
Unified Aurora launcher for official Claude Code and Codex clients.
Layout
packages/cli command entrypoints and init flow
packages/clients official Claude/Codex launch adapters
packages/sidecar local HTTP proxy for runtime traffic
packages/protocol shared rewrite/projection helpers
packages/state ~/.aurora state paths and JSON state
bin/ npm bin shims
lib/ current MVP support modulesInstall
Installing @auroraflow/code as a global npm package attempts to install/update the
official Claude Code and Codex global commands:
npm install -g @auroraflow/codeAurora does not export claude or codex bins. The standalone claude and
codex commands remain the official clients and keep their official behavior.
Aurora only wraps them through aurora-claude and aurora-codex.
To install or update the official clients explicitly:
aurora install-clients
aurora update-clientsCommands
npm run check
scripts/release_npm.sh 0.0.7
node bin/aurora.js
node bin/aurora.js init
node bin/aurora.js claude
node bin/aurora.js codex
node bin/aurora.js install-clients
node bin/aurora.js update-clients
node bin/aurora.js statusRunning aurora without a subcommand opens an interactive client selector. Use
Up/Down (or j/k) and Enter to launch Claude or Codex through Aurora.
The launcher stores shared local state under ~/.aurora and starts a local
sidecar at 127.0.0.1:17878. Official clients talk to the sidecar; the sidecar
injects the selected Aurora key/model and forwards runtime traffic to Aurora
Gateway.
The Aurora desktop client is the product path for model/key selection. Its local
runtime workbench writes ~/.aurora/agent-state.json; aurora-claude and
aurora-codex only consume that local runtime state and route official client
traffic through the sidecar. The clients are launched with the selected Aurora
model alias, and the sidecar enforces the same selected alias when forwarding
runtime requests.
aurora-codex also writes ~/.aurora/clients/codex/config.toml and
auth.json before launch so Codex uses the Aurora sidecar provider instead of
the OpenAI login flow.
