@agent-wasm/codex
v0.1.0
Published
Browser-hosted Codex sessions and WASM worker bridge for agent-wasm.
Readme
@agent-wasm/codex
The Codex agent for agent-wasm, compiled to WebAssembly and run in the browser.
Provides app-server and CLI browser sessions over a MessageChannel + worker,
a JSON-RPC peer, and a host bridge that routes the agent's fs / network / command
/ process effects to a @agent-wasm/core
container.
npm install @agent-wasm/codexAPI
createCodexBrowserSession/CodexBrowserSession— app-server session.createCodexCliBrowserSession/CodexCliBrowserSession— CLI session.createBrowserCodexCliShellCommand— a shell command factory.CodexHostBridge/CodexHostContainer/CodexHostAuthController— wire the WASM agent to a host container + auth.
Subpaths
| Import | Purpose |
| --- | --- |
| @agent-wasm/codex | the session/bridge API above |
| @agent-wasm/codex/cli-browser-worker | the CLI worker entrypoint |
| @agent-wasm/codex/app-server-browser-worker | the app-server worker entrypoint |
Note: the Rust → WASM artifacts are built from the vendored Codex crates via
wasm-pack; published builds ship the prebuilt.wasmunderdist/pkg.
The browser port currently tracks OpenAI Codex 0.145.0 (rust-v0.145.0).
Install the reproducibly pinned browser fork and build the adapter with:
pnpm vendor:install:codexTo validate or build a separate Codex checkout without replacing
vendor/codex, set CODEX_SOURCE_DIR:
CODEX_SOURCE_DIR=/path/to/codex pnpm nx check-codex-wasm codex-wasm
CODEX_SOURCE_DIR=/path/to/codex pnpm nx build-adapter codex-wasmLicense
MIT
