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을 읽기 위해 앱을 완전히 종료했다가 다시 열어야 합니다.