Skip to content

ultracodex 0.2.0

Choose a tag to compare

@YuanpingSong YuanpingSong released this 06 Jul 18:41

Second release — the dogfooding release. Everything here came from actually using ultracodex to run real work (and to build itself). npm install -g ultracodex

TUI

  • Phase navigation — the phase strip is now a tab bar. ←/→ filter the run view to one phase (All is the default); density tiers re-apply to the filtered list, so narrowing a big run to a small phase restores the rich card view. No auto-jump when a new phase starts mid-run.
  • Fits any terminal — the full-screen run view no longer overlap-garbles when content is taller than the window (previously broke at 80×24, macOS's default). The agent list windows to available rows with ↑/↓ N more markers, keeping the selected agent on screen; the result pane caps to fit. Verified via pty at 80×24 / 100×32 / 120×50.
  • Model per agent — every agent card shows backend·model even when the script doesn't pin a model. agent_start now journals the resolved model/effort (single-sourced with the executor, so the journal can't drift from what actually ran).

doctor

Now prints, beyond pass/fail checks:

  • the execution profile agents actually run with (model · effort · sandbox · network · service tier · approvals),
  • where that diverges from your interactive codex (~/.codex/config.toml — e.g. a service_tier = "fast" or approval policy the fleet doesn't inherit),
  • MCP servers your interactive config loads into every agent thread (a hidden source of per-agent startup latency),
  • a soft codex version-pin check.

Config & security

  • network_access — first-class [backends.codex] knob for egress inside the workspace-write sandbox (file confinement retained). Off by default; documented sandbox escalation ladder and exfiltration warning in docs/OPERATIONS.md.
  • extra_args for both backends; the claude backend defaults to --allowedTools Read Glob Grep so claude-routed judges can read the repo out of the box.

Release engineering

  • pnpm release <patch|minor|major> — one command: live pre-release gate → version bump + tag → push → publish (npm trusted publishing via OIDC, with provenance) → registry verification.
  • pnpm release:check — runs the demo-video haiku actor–critic loop live against real codex and asserts the run's intermediate state (journal events with resolved models, per-agent artifacts, schema'd critic outputs, token ledger), archiving each run as release provenance.
  • --version now reads package.json at runtime (0.1.1 mistakenly self-reported as 0.1.0).

Docs

Parent-verify (results return to your Claude session for judgment) is now the headline pattern; the in-run claude backend is documented as an advanced feature (ADR-0002). Two ADRs added: loop-engineering extensions (0001) and claude-backend positioning (0002).

Fixes came from real use: a founder inspecting a live research run found the missing per-agent model in seconds; the pre-release gate's own verification caught the 80×24 layout bug before it shipped.

Full changelog: v0.1.1...v0.2.0