Nanocodex Nightly (2026-07-22, 657d565b3f)

Automated nightly build from 657d565b3f.

Install it with nanocodex update --nightly.

Nanocodex Nightly (2026-07-22, 0b7391ac5d)

Automated nightly build from 0b7391ac5d.

Install it with nanocodex update --nightly.

Nanocodex Nightly

Automated nightly build from 657d565b3f.

Install it with nanocodex update --nightly.

Nanocodex v0.1.0

Blazing-fast, minimal, library-first reimplementation of Codex.

Nanocodex provides typed turns, tools, events, steering, cancellation, queueing,
and fast historical forks over the OpenAI Responses WebSocket API. It keeps the
complete coding-agent conversation inside your process without requiring an app
server or durable control plane.

API

Add the library:

[dependencies]
nanocodex = "0.1"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Build an agent, submit independently awaitable turns, and fork from completed
checkpoints:

let (agent, _events) = Nanocodex::new(api_key)?;

let turn = agent.prompt("Inspect this repository.").await?;
turn.steer("Focus on the failing tests.").await?;
let result = turn.result().await?;

let _follow_on = agent
    .prompt("Now propose a fix.")
    .await?
    .result()
    .await?;

let (historical, _events) = agent.fork_from(&result).await?;

prompt().await means accepted, not completed. The agent automatically retains
typed history, tools, cache identity, response chains, and its persistent
WebSocket across follow-on turns.

CLI

Install the native CLI on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/gakonst/nanocodex/master/install | bash

Run with an API key:

export OPENAI_API_KEY=...
nanocodex

Or reuse the same ChatGPT subscription credential store as Codex:

nanocodex auth login
nanocodex --chatgpt

Update an existing installation with:

nanocodex update

Included

• One owned agent lifecycle with typed TurnResults and optional ordered
  AgentEvents.
• Persistent Responses WebSocket sessions with replay-safe reconnects and
  client-owned typed history.
• Queued prompts, active-turn steering, explicit cancellation, and exact
  historical forks from completed checkpoints.
• Typed Rust tools via #[tool], Code Mode, local tools, and deferred MCP
  providers.
• Caller-owned Tower middleware around complete streamed Responses attempts.
• API-key and ChatGPT subscription authentication.
• Native CLI and TUI, headless JSONL adapter, and thin Python, Node, and
  Rust/WASM consumers of the same SDK.
• Seven published crates with crate-specific documentation and changelogs.
• Five max-performance binaries for macOS, Linux, and Windows, covered by
  SHA256SUMS.

Changes

Features

• feat: harden Code Mode and observability (#1) by @gakonst

Fixes

• Preserve assistant message phases in events (#3) by @gakonst
• Emit completed assistant items from Responses (#4) by @gakonst

Full changelog

d88d0a6...v0.1.0