Codex Agent View 0.4.5

Highlights

• Shows the first valid short request summary for each work item, with local redaction and strict 4,096-character inspection / 180-character display bounds.
• Replaces developer-centric parent-task/subagent wording with clearer work and participating-agent language.
• Removes session IDs from primary live cards while keeping project, request, agent role, status, and recent activity readable.
• Adds visible recovery actions for connection failures and missing or rejected live-view authentication.
• Keeps English as the default and provides English, Korean, and Spanish in the live language selector.
• Continues to exclude the viewer task itself when opened through the bundled Show Agents skill.

Privacy boundary

The full request and tool input are not transported or retained. The work-level summary is derived in the local sender, redacts common credentials, email addresses, links, and absolute paths, and remains bounded process-local memory. Official SubagentStart hooks do not provide a dedicated agent assignment description, so the UI does not invent one.

Verification

• 114/114 tests passed.
• Plugin validation and npm pack validation passed.
• Node 18, 20, and 22 GitHub Actions passed.
• The public npm tarball is byte-identical to the verified release tarball.
• Reinstalled exact public codex-agent-view@0.4.5 on the release machine and verified CLI/plugin 0.4.5, installed/enabled state, all nine hooks, real events, three-language switching, self-exclusion, request-summary redaction, authentication recovery, and the official Codex in-app live view.

Install

npm install --global codex-agent-view@0.4.5

codex-agent-view install

After installation, routine use stays inside the official Codex app.

Codex Agent View 0.4.4

Highlights

• Plugin Quick start no longer injects plain-text $show-agents; select the plugin, then explicitly choose the bundled Show Agents skill in Codex.
• The live viewer task excludes itself from task lists, search results, and summary counts.
• Added English, Korean, and Spanish UI with English as the default and a persistent language selector.
• Removed refresh-sensitive disclosure toggles; technical and diagnostic details remain visible inline.
• Shows verified subagent role/profile metadata without inventing assignment text that official hooks do not provide.
• Preserves viewer authentication across refreshes and exact-version reinstalls.

Verification

• 104/104 tests passed.
• Plugin validation and npm pack validation passed.
• Public npm tarball is byte-identical to the verified release tarball.
• Reinstalled codex-agent-view@0.4.4 from public npm on the release machine and verified installed/enabled plugin state, nine hook declarations, real events, language switching, self-exclusion, refresh authentication, and the official Codex in-app live view.

Install

npm install --global codex-agent-view@0.4.4

codex-agent-view install

After installation, routine use stays inside the official Codex app.

Codex Agent View 0.4.3

변경 사항

• 읽기 전용 viewer credential을 runtime/control token과 분리했습니다.
• 이미 열린 Codex 앱 live 탭이 모니터 재시작과 package upgrade 뒤 자동 재연결됩니다.
• 기존 0.4.2 설치의 legacy token을 안전하게 migration합니다.
• viewer credential은 상태 조회만 가능하며 event ingest와 shutdown은 거부합니다.
• 정상 제거 시 credential을 폐기하고, 형식을 알 수 없는 파일은 보존 경고합니다.

검증

• Node.js 18, 20, 22 CI 통과
• 99개 테스트 및 plugin validation 통과
• 공개 npm tarball과 release source tarball byte-identical
• 이 기기에서 public 0.4.3 exact install 및 plugin installed/enabled 확인
• 공식 Codex 앱 내 Browser에서 0.4.2 legacy 탭의 무인증오류 0.4.3 자동 재연결 E2E 통과

설치

npm install --global codex-agent-view@0.4.3
codex-agent-view install

설치 후 일반 사용은 공식 Codex 앱 안에서 plugin 카드의 Quick start 또는 @codex-agent-view $show-agents를 사용합니다.

Codex Agent View 0.4.2

핵심 변경

• 플러그인 카드의 지금 사용해보기 / Quick start가 이제 정확한 $show-agents를 입력해 bundled Show Agents skill을 명시적으로 실행합니다.
• 실시간 화면을 닫은 뒤에는 Codex 앱 task에서 @codex-agent-view $show-agents로 다시 열 수 있습니다.
• 실행 중인 부모 작업과 작업 에이전트를 먼저 보여주고, 원시 ID 대신 작업 에이전트 1, 조사 담당, 파일 수정 완료, 터미널 작업 실행 중처럼 사람이 읽는 문구를 우선합니다.
• 에이전트 번호는 시작 순서를 기준으로 안정적으로 유지되며, 같은 도구의 시작/완료 이벤트는 최신 상태 한 건으로 합쳐 오래된 실행 중 표시를 남기지 않습니다.
• 원시 session/agent ID와 hook 이벤트명은 접힌 기술 정보로 이동했습니다. Prompt와 tool input/output은 계속 수집·표시하지 않습니다.

설치

npm install --global codex-agent-view@0.4.2
codex-agent-view install

설치 뒤 Codex 앱을 완전히 다시 열고 새 task를 만드세요. Plugins 화면의 지금 사용해보기를 누르면 $show-agents가 시작됩니다. 화면을 닫았다면 Codex 앱 task에서 @codex-agent-view $show-agents를 사용하세요. 일반 사용 중에는 monitor CLI나 localhost 주소를 직접 관리할 필요가 없습니다.

검증

• 전체 테스트 85/85
• repository plugin validation 및 공식 plugin-creator validation 통과
• Show Agents skill quick validation 통과
• GitHub Actions Node 18·20·22 성공
• 공식 Codex 내장 Browser에서 running-first 인간 친화 UI 합성 E2E 완료
• public npm 0.4.2: Apache-2.0, bin mapping, registry signature, 25 files
• npm shasum fac95689395baa26f4ad9ff0cbefd0017d2ebd8d
• npm integrity sha512-FRTPoYxjBuPC6Usb+ylSfZsZVJKlKcHnQPaAPljekg0maTPn9POsBkS+auOcHz5jspg0AXcP8R63PM0WfCn2LQ==
• 배포 원본 tarball과 registry tarball byte-identical
• 이 기기에 public exact 0.4.2 재설치, CLI/plugin version 일치, installed/enabled, hook wiring 9종, release source와 설치 manifest/UI/skill byte 일치 확인

현재 열려 있던 Codex 앱 process는 설치 전 inventory를 유지할 수 있으므로, 새 plugin starter의 최종 카드 클릭 E2E는 앱을 완전히 다시 연 새 task에서 확인해야 합니다. 이 release는 prompt 없는 자동 panel 생성이나 Universal Plugins Directory 검색 노출을 주장하지 않습니다.

Codex Agent View 0.4.1

핵심 변경

• 플러그인 카드의 평문 Show Agents starter를 Open @ and select the bundled Show Agents skill. 안내로 교체했습니다.
• Codex 앱에서 실제 실행하는 경로를 새 task의 @ picker에서 bundled Show Agents skill 자체를 직접 선택하는 방식으로 고정했습니다.
• 선택된 skill에는 Open the live agent monitor. default prompt를 제공하고 implicit invocation은 계속 비활성화했습니다.
• $show-agents와 평문 starter가 실제 skill 호출인 것처럼 안내하지 않도록 validator와 계약 테스트를 보강했습니다.
• 영문 README와 별도 한글 안내서를 exact 0.4.1 설치 및 앱 내부 사용 흐름에 맞췄습니다.

설치

npm install --global codex-agent-view@0.4.1
codex-agent-view install

설치 뒤 Codex 앱을 완전히 다시 열고, Plugins 화면에서 설치·활성화와 hook trust를 확인한 다음 새 task를 만드세요. 새 task의 @ picker에서 bundled Show Agents skill을 직접 선택하면 됩니다.

Plugin 카드의 Quick start/바로 사용하기는 선택 방법을 설명하는 안내 text만 입력하며 skill 자체를 실행하지 않습니다.

검증

• Node test 81/81
• repository plugin validation 통과
• 공식 plugin-creator validation 통과
• npm package 25 files, unpacked size 193424 B
• npm shasum ee2ae0b8b36016f5c57bade067027202b1508d1d
• npm integrity sha512-WC4f5MPmvpkXeKM+1BVAYqW4+hoaUrB4yQFoUYgc0pnjyY7hP1CdSR5NJ3QWmvJ6Ikmmb1d+58UL4hkKoyhm1Q==
• 배포 원본 tarball과 registry tarball byte-identical
• 이 기기에 public exact 0.4.1을 다시 설치해 CLI/plugin version, installed/enabled, hook wiring 9종 확인

공식 Codex 앱 process는 설치 전에 열려 있었으므로 새 skill inventory와 실제 live panel의 최종 시각 E2E는 앱 완전 재시작과 새 task 뒤에 확인해야 합니다. 이 release는 검증하지 않은 자동 panel 생성이나 Universal Plugins Directory 검색 노출을 주장하지 않습니다.

Codex Agent View v0.4.0

Codex Agent View v0.4.0

공식 Codex 앱을 그대로 사용하면서 현재 task와 subagent 상태를 확인하는 로컬 read-only companion monitor의 앱 내 사용 흐름을 추가했습니다.

주요 변경 사항

• Codex 앱의 @ 메뉴에서 Codex Agent View → Show Agents를 선택해 live panel 열기를 요청할 수 있습니다.
• Trusted hook이 최초 event에서 로컬 backend를 자동으로 준비합니다. 일반 사용자는 task ID를 등록하거나 start, status, doctor를 실행하지 않습니다.
• Show Agents는 installed plugin과 전역 CLI version 불일치를 먼저 차단합니다. 일치할 때만 healthy monitor를 재사용하거나 내부적으로 start --no-open을 수행합니다.
• Token이 포함된 localhost URL은 대화나 사용자 안내에 노출하지 않고 외부 browser를 정상 흐름으로 열지 않습니다.
• Live UI는 같은 observation window에서 2초마다 갱신하고 일시 오류 뒤 재연결하며, 인증 거부는 무한 재시도하지 않습니다.
• uninstall과 --purge는 Codex Agent View가 소유한 monitor와 runtime file만 인증 후 정리합니다.
• GitHub와 npm 기본 README는 영어로 통일하고 전체 한국어 안내는 README.ko.md로 분리했습니다.

설치

최초 설치만 일반 terminal에서 실행합니다.

npm install --global codex-agent-view@0.4.0
codex-agent-view install

설치 뒤 Codex 앱을 완전히 다시 열고 plugin 설치·활성화와 hook definition을 검토한 다음 새 task를 만듭니다. 이후 @ 메뉴에서 Codex Agent View → Show Agents를 선택합니다. 일반 사용에는 별도 terminal이나 외부 browser가 필요하지 않습니다.

제품 경계

• 공식 plugin API는 앱 시작 시 prompt 없이 sidebar, panel 또는 Browser tab을 만들지 못하므로 최초 화면 열기에는 Show Agents 선택이 한 번 필요합니다.
• Live 상태는 bounded process-local memory만 사용하며 monitor 재시작은 새 observation window를 시작합니다.
• SQLite, 외부 server, 외부 telemetry, 원격 제어가 없습니다.
• 전체 prompt, transcript, tool input/output은 기본 저장하지 않습니다.
• Task/subagent 중지, message 전송, permission 승인·거절 기능은 제공하지 않습니다.

검증

• Node.js 18, 20, 22 CI
• 81개 테스트 통과
• Plugin/skill validation 통과
• npm package 25개 파일 검증
• Public registry tarball과 release tarball byte match
• 이 기기에 public exact 0.4.0 재설치 후 plugin installed/enabled, hook 9종 wiring, 실제 event 수신 확인

현재 Codex process가 plugin 설치 이전부터 열려 있었다면 새 skill inventory와 hook definition을 읽기 위해 앱을 완전히 종료했다가 다시 열어야 합니다.

v0.3.2 — Codex 앱 전용 설치 안내 교정

수정 내용

• npm에 게시된 README가 배포 전 후보 상태를 계속 안내할 수 있는 문제를 바로잡았습니다.
• README의 버전 안내를 패키지 자체 버전 기준으로 작성해, npm의 불변 패키지 안에서도 시간이 지나며 거짓이 되지 않도록 했습니다.
• 한글과 영문 설치 안내 모두 codex-agent-view@0.3.2를 정확히 사용합니다.

설치와 사용

최초 설치에만 터미널을 사용합니다.

npm install --global codex-agent-view@0.3.2
codex-agent-view install

Codex 앱이 열려 있었다면 완전히 다시 연 뒤 새 task를 만드세요. Plugins 화면에서 Codex Agent View가 설치·활성화됐는지 확인하고, 새 task의 @ 메뉴에서 codex-agent-view를 선택해 현재 task와 subagent 상태를 요청하면 됩니다.

설치 이후의 snapshot, 상태 확인, live 화면 열기는 공식 Codex 앱 안에서 수행합니다. 일반 사용자는 monitor 명령이나 localhost 주소를 관리하지 않습니다.

검증

• Node.js 18, 20, 22 CI 통과
• 전체 테스트 67개 통과
• Plugin validation 및 skill/package contract 통과
• 실제 npm tarball 21개 파일과 source의 byte 일치 확인
• postinstall과 production dependency 없음
• Read-only, local-memory, localhost-only 경계 유지

v0.3.1 — Codex 앱 전용 사용 흐름

핵심 변경

• 설치 이후의 정상 사용 경로를 공식 Codex 앱 안으로 명확히 통일했습니다.
• 사용자는 새 Codex 작업에서 @codex-agent-view를 호출해 현재 task와 subagent 상태를 확인할 수 있습니다.
• 라이브 화면도 Codex 앱 안에서 열도록 README와 plugin skill 계약을 정리했습니다.
• 일반 사용자에게 start, status, doctor, localhost 주소, 외부 브라우저 사용을 요구하지 않습니다.

설치

최초 설치에만 터미널을 사용합니다.

npm install --global codex-agent-view@0.3.1
codex-agent-view install

Codex 앱이 열려 있었다면 완전히 종료한 뒤 다시 열고 새 작업을 만드세요. Plugins 화면에서 codex-agent-view가 설치 및 활성화되어 있는지 확인한 뒤 새 작업에서 @codex-agent-view를 호출하면 됩니다.

안정성

• Node.js 22 환경에서 monitor 종료 시 간헐적으로 발생하던 signal handler 등록 순서 경쟁을 수정했습니다.
• Node.js 18, 20, 22에서 테스트했습니다.
• 전체 테스트, plugin validation, npm package dry-run을 통과했습니다.
• 외부 서버, 외부 telemetry, SQLite 없이 로컬 메모리와 localhost 범위만 사용합니다.
• plugin은 read-only이며 Codex task를 제어하지 않습니다.

제거

codex-agent-view uninstall
npm uninstall --global codex-agent-view

Codex Agent View 0.3.0

주요 변경 사항

• 공식 Codex 앱 안에서 여러 workspace의 실행 중인 task와 subagent를 조회하는 app-first snapshot을 기본 사용 경험으로 전환했습니다.
• active/running과 idle + hasUnreadTurn을 구분해, 방금 끝난 작업이 확인 전에 목록에서 사라지지 않도록 했습니다.
• 최신 agent commentary와 subAgentActivity를 제한된 범위에서 표시하며 prompt, preview, tool 입출력, 전체 workspace 경로와 내부 task ID는 기본 노출하지 않습니다.
• 선택형 hook monitor에는 전체 cwd 대신 정제된 workspace basename만 전달합니다.
• codex-agent-view start가 외부 브라우저를 자동 실행하지 않습니다. 외부 브라우저는 --open을 명시한 경우에만 엽니다.
• npm package와 Codex plugin manifest를 0.3.0으로 맞췄습니다.

검증

• Node 테스트 67/67 통과
• Plugin scaffold validation 통과
• Skill validation 통과
• 공식 Codex 앱에서 kyurasi-next-supabase task, 최신 진행 설명, subagent 활동과 완료 직후 확인 대기 상태를 직접 검증
• npm registry signature, SRI, gitHead 확인

설치

npm install --global codex-agent-view@0.3.0
codex-agent-view install

설치 후 이미 실행 중이던 Codex 앱은 완전히 재시작해야 새 plugin skill과 hook 정의가 로드됩니다.

Codex Agent View 0.2.1 — 자동 추적 복구

공식 Codex 앱용 로컬 read-only companion monitor의 자동 추적 복구 patch입니다.

주요 변경

• task ID 등록 없이 부모 task와 subagent를 hook으로 자동 수신
• SessionStart, SessionEnd, UserPromptSubmit, Stop hook wiring 추가
• 부모 turn과 session lifecycle 상태 계산
• 실행 중 agent, 권한 대기, 완료 상태 UI 반영
• 빈 화면에서 검색을 숨기고 검색을 선택 필터로 명확화
• plugin 설치·활성화·hook wiring·event 수신을 doctor에서 구분

검증

• 공식 Codex 앱 26.727.40816 build 6067에서 실제 자동 수신 확인
• 실제 hook 8종과 subagent running → stopped UI 전환 확인
• SessionEnd 실제 event는 아직 미관찰
• 테스트 55/55 및 plugin/package validation 통과
• public npm codex-agent-view@0.2.1 게시

설치
npm install --global codex-agent-view@0.2.1
codex-agent-view install
codex-agent-view start