Skip to content

Releases: plaonn/codex-radar

Release list

Codex Radar 0.4.19 Public Beta

Codex Radar 0.4.19 Public Beta Pre-release
Pre-release

Choose a tag to compare

View all tags
@plaonn plaonn released this 24 Jul 12:27
v0.4.19
e74e022

Codex Radar 0.4.19 Public Beta

Codex Radar 0.4.19 consolidates the extension work after the published v0.4.12 public beta. This prerelease pairs VSIX 0.4.19 with helper runtime 0.4.10; the two versions remain intentionally independent.

Highlights

  • Use the shared sanitized display-state export as the default VS Code list source, with the direct host-local adapter retained as a bounded fallback.
  • Negotiate transcript-preview v2 for locale-aware recorded times and date separators while preserving immutable v1 compatibility.
  • Add the explicit Open in Codex CLI integrated-terminal action with structured resume, session-id arguments and host-local cwd ownership.
  • Classify the Sidebar Current Workspace group from raw session cwd evidence before sanitized card conversion.
  • Preserve actionable missing, empty, and stale session-index setup diagnostics across shared-export success and fallback paths.
  • Open Sidebar transcript Preview from the selected in-memory session before background refresh, preventing the initial click from being delayed by catalog synchronization.
  • Include helper runtime 0.4.10, which carries the explicit idempotent hook-config --apply migration path introduced after v0.4.12 and preserves the stable shim path in generated hook configuration on POSIX.

Release Assets

  • codex-radar-helper-0.4.10.zip
  • codex-radar-helper-0.4.10.zip.sha256
  • codex-radar-vscode-0.4.19.vsix

The helper bundle contains a pure-Python 0.4.10 wheel and compatibility metadata for VS Code extension versions from 0.4.3 up to, but not including, 0.5.0.

Install

  1. Download the helper bundle, adjacent checksum, and VSIX from the intended GitHub Release.

  2. Verify and install the helper on a supported POSIX Python 3.9+ host:

    shasum -a 256 -c codex-radar-helper-0.4.10.zip.sha256
unzip codex-radar-helper-0.4.10.zip
cd codex-radar-helper-0.4.10
python3 install-helper.py install .

  3. Review the hook migration without writing:

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

  4. Apply only after an explicit user decision:

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

  5. Install the VSIX on the same local or Remote SSH extension host:

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

Privacy and Automation Boundaries

  • Install, upgrade, rollback, diagnose, and the VS Code extension do not edit Codex hook configuration.
  • hook-config --apply is a separate explicit migration action. It preserves unrelated hooks, normalizes Radar-owned entries, creates a backup for changed writes, and validates the readback.
  • The VS Code GUI remains read-oriented for Codex and Radar runtime state. Open in Codex CLI runs only after a user-visible action.
  • Transcript/session metadata remains host-local. Shared display state excludes raw cwd, transcript paths, raw content, and private runtime paths.
  • Marketplace/PyPI publication and account/credential actions require separate approval.

Native Windows Status

  • The helper bundle contains the implemented Native Windows foundation and generated Windows-compatible assets.
  • Native Windows support is not complete until a real Codex hook updates %LOCALAPPDATA%\codex-radar\state\sessions.json and the VS Code sidebar shows that exact session.
  • Windows CI, WSL2, candidate packaging, and POSIX smoke do not replace the real-host gate.
  • This POSIX public beta does not complete or replace the separate Native Windows real-host validation.

Release Verification

  • Run the full Python unit suite and compileall.
  • Run the full VS Code extension test suite.
  • Build and inspect the 0.4.10 wheel and helper bundle.
  • Build and inspect the 0.4.19 VSIX.
  • Confirm artifact filenames, embedded versions, compatibility metadata, checksums, and packaged file inventory.
  • Complete a disposable POSIX helper install/upgrade/diagnose smoke.
  • Keep this publication and the Native Windows real-host smoke as separate milestones.

한국어

Codex Radar 0.4.19는 게시된 v0.4.12 공개 베타 이후의 확장 작업을 다음 공개 베타로 묶습니다. 이 prerelease는 VSIX 0.4.19와 helper runtime 0.4.10을 함께 제공하며 두 version은 의도적으로 독립적으로 관리됩니다.

주요 변경 사항

  • Shared sanitized display-state export를 VS Code list의 기본 source로 사용하고 direct host-local adapter를 제한된 fallback으로 유지합니다.
  • Immutable v1 호환성을 유지하면서 transcript-preview v2를 명시적으로 협상해 기록 시각과 날짜 구분선을 표시합니다.
  • Structured resume, session-id argument와 host-local cwd를 사용하는 명시적 Open in Codex CLI integrated-terminal action을 추가합니다.
  • Sanitized card 변환 전에 raw session cwd로 Sidebar Current Workspace를 분류합니다.
  • Shared-export 성공과 fallback 경로에서도 missing, empty, stale session-index 진단을 보존합니다.
  • Sidebar 선택 직후 in-memory session으로 Preview를 먼저 열고 catalog 동기화는 background에서 수행합니다.
  • v0.4.12 이후 추가된 명시적이고 idempotent한 hook-config --apply migration path를 포함하고 POSIX generated hook config에서 stable shim path를 보존하는 helper runtime 0.4.10을 제공합니다.

릴리스 산출물

  • codex-radar-helper-0.4.10.zip
  • codex-radar-helper-0.4.10.zip.sha256
  • codex-radar-vscode-0.4.19.vsix

Helper bundle에는 pure-Python 0.4.10 wheel과 VS Code extension 0.4.3 이상 0.5.0 미만의 compatibility metadata가 포함됩니다.

설치

지원되는 POSIX Python 3.9+ host에서 bundle/checksum을 검증하고 helper를 설치한 뒤, hook migration을 먼저 no-write로 검토합니다. hook-config --apply는 사용자가 명시적으로 선택한 경우에만 실행합니다. 같은 local 또는 Remote SSH extension host에 codex-radar-vscode-0.4.19.vsix를 설치합니다.

개인정보 보호 및 자동화 경계

  • Install, upgrade, rollback, diagnose, VS Code extension은 Codex hook config를 수정하지 않습니다.
  • hook-config --apply는 별도의 명시적 migration action이며 관련 없는 hook을 보존하고 Radar-owned entry만 정규화합니다.
  • VS Code GUI는 Codex/Radar runtime state에 대해 read-oriented 상태를 유지합니다. Open in Codex CLI는 사용자가 명시적으로 선택했을 때만 실행됩니다.
  • Transcript/session metadata는 host-local로 유지하고 shared display state에는 raw cwd, transcript path/content, private runtime path를 포함하지 않습니다.
  • Marketplace/PyPI publication과 account/credential action은 별도 승인이 필요합니다.

Native Windows 상태

  • Helper bundle에는 구현된 Native Windows foundation과 generated Windows-compatible asset이 포함됩니다.
  • 실제 Codex hook이 %LOCALAPPDATA%\codex-radar\state\sessions.json을 갱신하고 VS Code sidebar가 같은 session을 표시하기 전에는 Native Windows 지원 완료가 아닙니다.
  • Windows CI, WSL2, candidate packaging, POSIX smoke는 real-host gate를 대체하지 않습니다.
  • 이 POSIX 공개 베타는 별도의 Native Windows real-host validation을 완료하거나 대체하지 않습니다.

릴리스 검증

  • 전체 Python unit test와 compileall을 실행합니다.
  • 전체 VS Code extension test를 실행합니다.
  • 0.4.10 wheel/helper bundle과 0.4.19 VSIX를 생성하고 검사합니다.
  • Artifact filename, embedded version, compatibility metadata, checksum, package inventory를 확인합니다.
  • Disposable POSIX helper install/upgrade/diagnose smoke를 완료합니다.
  • 이번 publication과 Native Windows real-host smoke는 별도 milestone으로 유지합니다.
Loading

Codex Radar 0.4.12 Public Beta

Codex Radar 0.4.12 Public Beta Pre-release
Pre-release

Choose a tag to compare

View all tags
@plaonn plaonn released this 20 Jul 06:50
v0.4.12
a801a4f

Codex Radar 0.4.12 Public Beta Candidate

Codex Radar 0.4.12 packages the post-0.4.4 reliability and host-integration work as the next GitHub Release candidate. The candidate pairs VSIX 0.4.12 with helper runtime 0.4.7; the two versions remain intentionally independent.

Highlights

  • Add a reusable Codex App Server Controller for read-only thread catalog and supported account/rateLimits/read usage access.
  • Preserve the rollout usage adapter as a local fallback and parity observation source.
  • Add the Native Windows helper foundation, Windows state and locking semantics, stable .cmd shims, atomic runtime selection, and windows-latest CI coverage.
  • Add the opt-in foreground codex-radar thread rpc host and one-shot thread doctor, start, list, read, and send commands.
  • Add bounded persisted terminal-state reconciliation for missed Stop hooks and run it before foreground watch polling.
  • Stabilize sidebar interaction identity across asynchronous refreshes.
  • Classify Codex memory-maintenance sessions as Codex internal across CLI, TUI, shared export, and the VS Code direct reader without rewriting the session cache.

Candidate Assets

  • codex-radar-helper-0.4.7.zip
  • codex-radar-helper-0.4.7.zip.sha256
  • codex-radar-vscode-0.4.12.vsix

The helper bundle includes a pure-Python 0.4.7 wheel and compatibility metadata for VS Code extension versions from 0.4.3 up to, but not including, 0.5.0.

Install

After the candidate is explicitly approved and published as a GitHub Release:

  1. Download the helper bundle, adjacent checksum, and VSIX from the release.

  2. Verify the helper bundle:

    sha256sum --check codex-radar-helper-0.4.7.zip.sha256

  3. Install or upgrade the helper runtime:

    unzip codex-radar-helper-0.4.7.zip
cd codex-radar-helper-0.4.7
python3 install-helper.py install .

  4. Review the hook configuration without modifying it automatically:

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

  5. Install the VSIX on the same local or Remote SSH extension host:

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

Privacy and Automation Boundaries

  • Codex Radar does not edit ~/.codex/hooks.json, install hooks automatically, or send transcript/session data externally.
  • The VS Code GUI remains read-only for Codex and Radar runtime state. App-server GUI access is limited to thread metadata and rate-limit reads.
  • codex-radar thread rpc is an explicit foreground stdio surface. It does not open a network listener, install a daemon, or auto-approve command, file, or permission requests.
  • Display-state export omits raw working directories, transcript paths, transcript text, hook payloads, and private runtime paths.
  • Shared display-state export remains in observation mode by default. Export failure or schema mismatch retains the direct adapter fallback.

Current Limitations

  • The supported public-beta distribution path remains GitHub Releases, not the VS Code Marketplace or PyPI.
  • Native Windows foundation and CI are present, but Windows support is not complete until a real Codex hook updates %LOCALAPPDATA%\codex-radar\state\sessions.json and the VS Code sidebar displays the same session.
  • The published helper asset remains a POSIX public-beta path until that Native Windows smoke and a separate Windows release decision are complete.
  • Abrupt extension-host loss can leave a directly owned app-server child alive. Radar does not use process-name/PPID sweeps or an undocumented daemon/proxy to hide that boundary.
  • Same-workspace Codex handoff still uses an experimental local URI route.

Release Gate

Before publication:

  • Run the full Python unit suite and compileall.
  • Run the full VS Code extension test suite.
  • Build and inspect the 0.4.7 wheel and helper bundle.
  • Build and inspect the 0.4.12 VSIX.
  • Confirm artifact filenames and embedded manifest versions.
  • Complete an extension-host smoke with the current helper and VSIX.
  • Obtain explicit approval before creating the GitHub Release.

한국어

Codex Radar 0.4.12는 0.4.4 이후의 안정성 개선과 host 통합 작업을 다음 GitHub Release 후보로 묶습니다. 이 후보는 VSIX 0.4.12와 helper runtime 0.4.7을 함께 제공하며, 두 버전은 의도적으로 독립적으로 관리됩니다.

주요 변경 사항

  • Read-only thread catalog와 지원되는 account/rateLimits/read usage 조회를 위한 재사용 가능한 Codex App Server Controller를 추가합니다.
  • Rollout usage adapter는 로컬 fallback과 parity 관찰 source로 유지합니다.
  • Native Windows helper foundation, Windows state/locking 동작, stable .cmd shim, atomic runtime 선택, windows-latest CI 검증을 추가합니다.
  • 명시적으로 실행하는 foreground codex-radar thread rpc host와 one-shot thread doctor, start, list, read, send command를 추가합니다.
  • 누락된 Stop hook을 보정하기 위한 bounded persisted terminal-state reconciliation을 추가하고 foreground watch polling 전에 실행합니다.
  • 비동기 refresh 중에도 sidebar interaction이 같은 session identity를 유지하도록 안정화합니다.
  • Codex 메모리 관리 session을 cache rewrite 없이 CLI, TUI, shared export, VS Code direct reader에서 Codex internal로 분류합니다.

후보 산출물

  • codex-radar-helper-0.4.7.zip
  • codex-radar-helper-0.4.7.zip.sha256
  • codex-radar-vscode-0.4.12.vsix

Helper bundle에는 pure-Python 0.4.7 wheel과 VS Code extension 0.4.3 이상 0.5.0 미만을 대상으로 하는 compatibility metadata가 포함됩니다.

설치

후보가 명시적으로 승인되어 GitHub Release로 게시된 뒤 다음 순서로 설치합니다.

  1. Release에서 helper bundle, checksum, VSIX를 다운로드합니다.

  2. Helper bundle을 검증합니다.

    sha256sum --check codex-radar-helper-0.4.7.zip.sha256

  3. Helper runtime을 설치하거나 업그레이드합니다.

    unzip codex-radar-helper-0.4.7.zip
cd codex-radar-helper-0.4.7
python3 install-helper.py install .

  4. Hook 설정을 자동 변경하지 않고 필요한 차이를 검토합니다.

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

  5. 같은 local 또는 Remote SSH extension host에 VSIX를 설치합니다.

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

개인정보 보호와 자동화 경계

  • Codex Radar는 ~/.codex/hooks.json을 편집하거나 hook을 자동 설치하지 않으며 transcript/session 데이터를 외부로 전송하지 않습니다.
  • VS Code GUI는 Codex와 Radar runtime state에 대해 read-only로 유지됩니다. GUI의 app-server 접근은 thread metadata와 rate-limit 조회로 제한됩니다.
  • codex-radar thread rpc는 명시적으로 실행하는 foreground stdio surface입니다. Network listener나 daemon을 설치하지 않으며 command, file, permission request를 자동 승인하지 않습니다.
  • Display-state export에는 raw working directory, transcript path/text, hook payload, private runtime path가 포함되지 않습니다.
  • Shared display-state export는 기본 observe 모드를 유지합니다. Export 실패 또는 schema mismatch가 발생하면 direct adapter fallback을 유지합니다.

현재 제한 사항

  • 지원되는 공개 베타 배포 경로는 GitHub Releases이며 VS Code Marketplace와 PyPI에는 게시하지 않습니다.
  • Native Windows foundation과 CI는 준비되어 있지만, 실제 Codex hook이 %LOCALAPPDATA%\codex-radar\state\sessions.json을 갱신하고 VS Code sidebar가 같은 session을 표시하는 smoke 전에는 Windows 지원 완료로 선언하지 않습니다.
  • 해당 Native Windows smoke와 별도 release 결정 전까지 게시되는 helper asset은 POSIX 공개 베타 경로로 취급합니다.
  • Extension host가 비정상 종료되면 직접 소유한 app-server child가 남을 수 있습니다. Radar는 이 경계를 숨기기 위해 process-name/PPID sweep이나 undocumented daemon/proxy를 사용하지 않습니다.
  • Same-workspace Codex handoff는 계속 experimental local URI route를 사용합니다.

Release 전 확인

  • 전체 Python unit test와 compileall을 실행합니다.
  • 전체 VS Code extension test를 실행합니다.
  • 0.4.7 wheel과 helper bundle을 생성하고 검사합니다.
  • 0.4.12 VSIX를 생성하고 검사합니다.
  • 산출물 파일명과 embedded manifest version을 확인합니다.
  • Current helper와 VSIX로 extension-host smoke를 완료합니다.
  • GitHub Release를 만들기 전에 명시적 승인을 받습니다.
Loading

Codex Radar 0.4.4 Public Beta

Codex Radar 0.4.4 Public Beta Pre-release
Pre-release

Choose a tag to compare

View all tags
@plaonn plaonn released this 15 Jul 08:05
v0.4.4
dc27eea

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를 통과한 뒤 배포합니다.

Loading

Codex Radar 0.4.3 Public Beta

Codex Radar 0.4.3 Public Beta Pre-release
Pre-release

Choose a tag to compare

View all tags
@plaonn plaonn released this 13 Jul 14:29
v0.4.3
063cf4f

Codex Radar 0.4.3 Public Beta

Codex Radar 0.4.3 improves host-local usage visibility, archive refresh, public setup documentation, and cross-workspace handoff safety while preserving the local-only read boundary.

Highlights

  • Identify the 5-hour and 7-day Codex usage pools by their observed window_minutes, including correct display when only the 7-day pool is present.
  • Refresh Radar navigation when archived transcript files are created or removed on the extension host.
  • Make cross-workspace handoff an explicit two-step flow: open the destination project first, then select the session from Radar in that window.
  • Clarify the helper/indexer dependency, explicit hook setup, empty-state diagnostics, privacy boundary, and Remote SSH installation path in the public documentation.

Install

  1. Install the host-local helper/indexer from this source checkout:

    python3 -m venv .venv
. .venv/bin/activate
python -m pip install .

  2. Configure the Codex lifecycle hook by following the hook setup runbook. Codex Radar does not edit ~/.codex/hooks.json or install hooks automatically.

  3. Download codex-radar-vscode-0.4.3.vsix from this GitHub Release and install it on the VS Code extension host where Codex and Radar state live:

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

For Remote SSH, run the helper and install the VSIX on the remote extension host.

Cross-workspace Handoff

When a selected session belongs to another workspace, Open Project in New Window opens only that project. Select the same session from Codex Radar in the destination window to open it in Codex. This avoids relying on VS Code's global URI routing to choose a destination window.

Privacy and Boundaries

Codex Radar remains local-only. Session state, transcript-derived previews, and usage snapshots stay on the extension host. The extension remains a read-only client of the host-local helper/indexer and does not silently configure hooks or send transcript/session metadata externally.

Current Limitations

  • Distributed through GitHub Releases, not the VS Code Marketplace.
  • Requires a separately installed host-local helper/indexer and explicit hook setup.
  • Same-workspace Codex handoff still relies on an experimental local URI route and may be unavailable for some sessions.
  • No OS or external notifications; attention cues remain inside Codex Radar or the opt-in terminal watcher.

Verification

The 0.4.3 package passed the repository Python and VS Code extension test suites. The cross-workspace two-step flow was manually smoke-tested before release.

한국어 요약

Codex Radar 0.4.3은 5시간/7일 usage pool 식별, archive 상태 자동 갱신, 공개 설치 문서, 다른 workspace handoff 안전성을 개선한 public beta임. 다른 workspace의 session을 열 때는 새 VS Code 창만 먼저 열고, 대상 창의 Radar에서 같은 session을 다시 선택하는 명시적 2단계 흐름을 사용함. Host-local helper/indexer와 사용자가 직접 설정한 Codex hook이 필요하며, Marketplace 배포, hook 자동 설치, 외부 데이터 전송은 포함하지 않음.

Loading

Codex Radar 0.4.0 Public Beta

Codex Radar 0.4.0 Public Beta Pre-release
Pre-release

Choose a tag to compare

View all tags
@plaonn plaonn released this 11 Jul 15:28
v0.4.0
d24c44c

Codex Radar 0.4.0 Public Beta

Codex Radar makes host-local Codex work easier to scan and resume across projects. A lightweight Python helper indexes lifecycle events into local state; the VS Code extension reads that state to show what is running, waiting for approval, done, or archived.

Highlights

  • Project-grouped Attention, Projects, and Archived views plus an editor dashboard.
  • Bounded, redacted conversation previews and clear running, approval, done/read, unknown, and archived states.
  • Workspace-aware handoff to eligible threads in the official Codex extension, including Remote SSH windows.
  • Setup diagnostics for missing, empty, stale, or unsupported local session indexes.
  • Dependency-free CLI/TUI fallback and experimental read-only host-local usage visibility.

Install

  1. Install the host-local helper/indexer from this source checkout:

    python3 -m venv .venv
. .venv/bin/activate
python -m pip install .

  2. Configure the Codex lifecycle hook by following the hook setup runbook. Setup is explicit: Codex Radar does not edit ~/.codex/hooks.json or install hooks for you.

  3. Download codex-radar-vscode-0.4.0.vsix from this GitHub Release and install it on the VS Code extension host where Codex and the Radar state live:

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

For Remote SSH, run the helper and install the VSIX on the remote extension host.

Privacy and Boundaries

Codex Radar is local-only. Session state, transcript-derived previews, and usage snapshots remain on the extension host. Primary navigation uses sanitized local state and does not send transcript or session metadata externally. The extension is a client of the host-local helper/indexer; it is not extension-only and does not silently configure hooks.

Current Limitations

  • Distributed through GitHub Releases, not the VS Code Marketplace.
  • Requires a separately installed host-local helper/indexer and explicit hook setup.
  • Codex handoff relies on an experimental local URI route and may be unavailable for some sessions.
  • No OS or external notifications; attention cues remain inside Codex Radar or the opt-in terminal watcher.

Verify

Run codex-radar doctor and codex-radar path, then open the Codex Radar Activity Bar view. Confirm that indexed sessions appear under the expected projects and that no hook, transcript, session-index, or config file is modified by the extension.

한국어 요약

Codex Radar 0.4.0은 GitHub Release VSIX로 배포하는 public beta임. Host-local helper/indexer와 사용자가 직접 설정한 Codex hook이 필요하며, Marketplace 배포, hook 자동 설치, 외부 데이터 전송은 포함하지 않음.

Loading