Skip to content

Codex Radar 0.4.4 Public Beta

Pre-release
Pre-release

Choose a tag to compare

@plaonn plaonn released this 15 Jul 08:05
· 72 commits to main since this release

Codex Radar 0.4.4 Public Beta

Codex Radar 0.4.4 introduces the first GitHub Release helper bundle and a shared sanitized display-state contract while keeping the existing direct VS Code reader available during migration.

Highlights

  • Add codex-radar export state --json for versioned, path-free display state shared by local clients.
  • Add explicit bounded transcript previews through codex-radar export preview <session-id> --limit <n>.
  • Add a POSIX Python 3.9+ helper bundle with verified artifacts, immutable versioned runtimes, a stable command shim, atomic upgrade selection, and rollback.
  • Add read-only codex-radar-helper diagnose checks for the selected runtime, stable shims, local compatibility metadata, and actual hook wiring.
  • Add VS Code observe, direct, and export read modes. The default observe mode keeps the direct adapter effective while checking shared-export semantic parity locally.

Install

  1. Download these assets from this GitHub Release:

    • codex-radar-helper-0.4.4.zip
    • codex-radar-helper-0.4.4.zip.sha256
    • codex-radar-vscode-0.4.4.vsix
  2. Verify and install the helper bundle on the extension host:

    sha256sum --check codex-radar-helper-0.4.4.zip.sha256
    unzip codex-radar-helper-0.4.4.zip
    cd codex-radar-helper-0.4.4
    python3 install-helper.py install .

    The checksum detects corruption but does not independently authenticate the publisher. Obtain the bundle, checksum, and installer from the intended GitHub Release over trusted TLS.

  3. Preview the required Codex hook configuration and merge it manually:

    ~/.local/bin/codex-radar-helper hook-config --hooks-file ~/.codex/hooks.json

    Codex Radar never edits ~/.codex/hooks.json automatically. Follow the hook setup runbook.

  4. Install the VSIX on the same local, Remote SSH, WSL, or Dev Container extension host:

    code --install-extension codex-radar-vscode-0.4.4.vsix --force

Upgrade and Diagnosis

The helper installer retains earlier immutable runtimes and atomically changes the current selection. Inspect the installation or roll back with:

~/.local/bin/codex-radar-helper diagnose
~/.local/bin/codex-radar-helper status
~/.local/bin/codex-radar-helper rollback

Hook changes remain an explicit user-reviewed migration. Installing, upgrading, rolling back, or diagnosing the helper does not modify Codex configuration.

Privacy and Migration Boundaries

  • Display-state export omits raw working directories, transcript paths, transcript text, hook payloads, and private runtime paths.
  • Transcript export occurs only for an explicitly selected session and is bounded and redacted.
  • VS Code keeps read/unread state extension-local and uses direct cwd/transcript metadata only inside the trusted extension host for workspace handoff and preview fallback.
  • Version 0.4.4 defaults to observation mode. Export failure, source unavailability, or schema mismatch retains the direct adapter as a one-release fallback.
  • No session or transcript data is sent to an external service.

Current Limitations

  • Distributed through GitHub Releases, not the VS Code Marketplace or PyPI.
  • The first helper bundle supports POSIX hosts with Python 3.9 or later; Windows packaging remains a separate milestone.
  • Helper diagnostics can verify only local compatibility metadata and do not query whether a newer release exists.
  • Same-workspace Codex handoff still relies on an experimental local URI route and may be unavailable for some sessions.

Verification

The release passed 123 Python tests and 125 VS Code extension tests. The helper bundle builder is byte-reproducible for identical wheel input, and the packaged VSIX manifest and shared-export adapter were verified against the source tree. Manual extension-host smoke testing confirmed helper installation, the 0.4.4 VSIX, default observation mode, session/preview behavior, seven-day-only usage placement, and cross-workspace new-window handoff.

한국어 요약

Codex Radar 0.4.4는 GitHub Release용 POSIX helper bundle, stable shim/원자적 upgrade/rollback, 읽기 전용 설치 진단, 공유 sanitized display-state 및 bounded transcript preview contract를 도입한 public beta 후보입니다. VS Code 확장은 기본 observe 모드에서 기존 direct reader를 유지하면서 export 의미 일치를 로컬에서 확인하며, 한 release 동안 실패 시 direct source로 fallback합니다. Hook 설정은 계속 사용자가 직접 검토·반영해야 하고, transcript/session 데이터는 외부로 전송되지 않습니다. 실제 extension host smoke test를 통과한 뒤 배포합니다.