Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Codex Trace는 OpenAI Codex CLI 세션 로그를 시각화하고 관리하는 데스크톱 애플리케이션입니다. 이 도구는 JSONL 형식의 로컬 대화 기록을 탐색, 검색, 실시간 추적할 수 있게 하며, 토큰 사용량 및 다양한 AI 상호작용 이벤트(도구 호출 등)를 상세하게 보여줍니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Coding Assistants의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기CI
License: MIT
Rust
React
Tauri
Platform
Codex Trace는 ~/.codex/sessions/에 저장된 로컬 JSONL 파일용 OpenAI Codex CLI 세션 로그 뷰어입니다.
데스크톱 앱과 웹 UI에서 Codex CLI 대화를 탐색하고, 검색하며, 실시간으로 추적(live-tail)하고 검사할 수 있습니다. Codex Trace는 Codex CLI JSONL 세션 파일을 도구 호출(tool calls), 토큰 카운트, 타임스탬프, 협업 체인(collaboration chains), 그리고 진행 중인 세션을 위한 실시간 SSE 테일링(live SSE tailing)이 포함된 읽기 쉬운 턴(turns)으로 렌더링합니다.
Codex Trace를 사용해야 하는 경우:
~/.codex/sessions/에서 OpenAI Codex CLI 대화 기록 보기Codex Trace는 또한 로컬 에이전트를 오케스트레이션하는 개인 AI 하네스 플랫폼인 DovePaw Lite를 지원하고 구축하는 데 사용됩니다.
Claude Code 사용자라면 대신 claude-code-trace를 확인하세요.
Codex Trace desktop app showing OpenAI Codex CLI JSONL session logs, turns, tool calls, token counts, and collaboration chains
~/.codex/sessions/에서 로컬 Codex CLI 세션 파일을 읽습니다.Codex CLI는 로컬 세션 기록을 JSONL 파일로 저장합니다. 이 파일들은 AI 코딩 세션을 디버깅하고 검토하는 데 유용하지만, 직접 읽기는 어렵습니다. Codex Trace는 Codex CLI 로그를 대화 검색, 도구 사용량 검사, 토큰 수 검토, 협업 체인 추적, 그리고 Codex 워크플로우의 빠른 디버깅이 가능한 인터랙티브 세션 뷰어로 변환합니다.
일반적인 관측 가능성 플랫폼(observability platforms)과 달리, Codex Trace는 ~/.codex/sessions/에서 나오는 로컬 Codex CLI 세션 로그에 초점을 맞춥니다. 외부 서비스로 트레이스를 전송할 필요가 없습니다.
Codex Trace는 개인 AI 하네스(harnesses) 및 로컬 에이전트 플랫폼을 구축할 때 특히 유용합니다. Codex CLI 세션을 검사하고, 도구 사용법을 이해하며, 협업 체인을 따라가고, DovePaw Lite와 같은 프로젝트를 구동하는 워크플로우를 디버깅할 수 있도록 돕습니다.
⚠️ [팁]
클론(clone) 필요 없음. 빌드 도구 필요 없음. xattr도 필요 없음. 터미널에 이것을 붙여넣으세요:
curl -fsSL https://raw.githubusercontent.com/PixelPaw-Labs/codex-trace/main/script/install-macos.sh | bash
이 명령어는 최신 릴리스를 다운로드하여 Codex Trace.app을 /Applications에 설치하며, Spotlight에서 바로 열 수 있습니다.
macOS는 다운로드된 것으로 표시된 서명되지 않은 앱을 차단하는데, curl은 해당 플래그를 절대 설정하지 않기 때문에, 별도의 격리(quarantine) 우회 작업 없이 앱이 그냥 열립니다. 이것이 macOS 릴리스가 .dmg 대신 .app.tar.gz 형태로 배포되는 이유입니다. Apple Silicon 전용입니다.
특정 버전을 고정하거나 다른 곳에 설치하려면 다음을 사용하세요:
curl -fsSL https://raw.githubusercontent.com/PixelPaw-Labs/codex-trace/main/script/install-macos.sh \
| CODEXTRACE_VERSION=v0.5.0 CODEXTRACE_INSTALL_DIR=~/Applications bash
Linux 및 Windows 빌드는 Releases 페이지에서 확인할 수 있습니다.
Rust와 Node.js가 설치된 상태에서 macOS, Linux 또는 Windows에서 Codex Trace를 로컬로 빌드하려면 이 옵션을 사용하세요.
git clone https://github.com/PixelPaw-Labs/codex-trace.git
cd codex-trace
./script/install.sh # macOS → /Applications에 Codex Trace.app; Linux → cargo binary
...
git clone https://github.com/PixelPaw-Labs/codex-trace.git
cd codex-trace
npm install
...
Docker는 웹 모드에만 지원됩니다.
docker build -t codex-trace .
docker run --rm -p 1422:1422 \
-v "$HOME/.codex/sessions:/home/app/.codex/sessions:ro" \
...
또는 Docker Compose를 사용하세요:
docker compose up --build
Codex Trace는 이 기본 경로에서 세션 파일을 읽습니다:
~/.codex/sessions/YYYY/MM/DD/rollout-{ISO_TIMESTAMP}-{UUID}.jsonl
사이드바는 폴더 구조를 정확하게 반영합니다. YYYY/MM/DD 형식의 날짜 그룹은 접거나 펼칠 수 있으며, 그 아래에 Codex CLI 세션이 표시됩니다.
설정(Settings)에서 ,를 눌러 세션 디렉터리를 변경할 수 있습니다.
기본 세션 디렉터리:
~/.codex/sessions
헤드리스 및 Docker 모드를 위한 환경 변수:
| 변수 | 기본값 | 설명 |
|---|---|---|
CODEXTRACE_HTTP_HOST | 127.0.0.1 | 바인딩 호스트 |
| ... |
npm install
npm run dev # Vite dev server, 프론트엔드 전용
npm run tauri dev # 전체 Tauri 앱
npm run check # tsc + oxlint + oxfmt + cargo clippy/fmt/test
풀 리퀘스트를 제출하기 전에 검사를 실행하세요.
버그 보고, 기능 요청 및 풀 리퀘스트를 환영합니다. 제출하기 전에 npm run check를 실행하세요. 이 명령어는 TypeScript, 린팅, 포맷팅, Clippy, Rust 포맷팅 및 Rust 테스트를 모두 포함합니다.