Codex Monitor

워크스페이스 및 스레드 관리

작업 공간을 추가하고 지속시키고, 그룹화 및 정렬하며, 홈 대시보드에서 최근 에이전트 활동으로 바로 이동할 수 있습니다. 각 작업 공간당 하나의 codex app-server를 스폰하여 스레드를 재개하고 읽지 않음/실행 중 상태를 추적합니다. 워크트리와 클론 에이전트를 위한 격리된 작업 공간을 제공하며, 워크트리는 앱 데이터 디렉터리에 저장됩니다(레거시 .codex-worktrees 지원). 스레드 관리를 통해 고정/이름 변경/아카이브/복사, 스레드별 초안, 진행 중인 턴 중단/중단을 수행할 수 있습니다. 원격 백엔드(데몬) 모드를 선택적으로 활성화하여 다른 머신에서 Codex를 실행할 수 있으며, Tailscale 탐지/호스트 부트스트랩을 통한 자체 호스팅 연결 설정을 지원합니다.

컴포저 및 에이전트 컨트롤

이미지 첨부(선택기, 드래그 앤 드롭, 붙여넣기)와 함께 구성할 수 있으며, 실행 중인 런에 대한 후속 동작을 Queue 대 Steer로 구성할 수 있습니다. macOS에서는 Shift+Cmd+Enter, Windows/Linux에서는 Shift+Ctrl+Enter를 눌러 단일 메시지에 대한 반대 후속 동작을 보낼 수 있습니다. 기술($), 프롬프트(/prompts:), 리뷰(/review), 파일 경로(@)에 대한 자동 완성을 제공합니다. 모델 선택기, 협업 모드(활성화 시), 추론 노력, 접근 모드, 컨텍스트 사용량 링을 사용할 수 있습니다. 홀드-투-토크 단축키와 실시간 파형(Whisper)을 이용한 음성 입력을 지원합니다. reasoning/tool/diff 항목을 렌더링하고 승인 프롬프트를 처리합니다.

Git 및 GitHub 통합

디프 통계, 스테이지드/언스테이지드 파일 디프, 되돌리기/스테이지 컨트롤, 커밋 로그를 제공합니다. 브랜치 목록과 함께 체크아웃/생성 및 업스트림 선행/후행 카운트를 표시합니다. gh를 통해 GitHub 이슈 및 풀 리퀘스트(목록, 디프, 댓글)를 지원하고, 브라우저에서 커밋/PR을 열 수 있습니다. PR 컨포저 기능을 통해 “Ask PR”로 PR 컨텍스트를 새로운 에이전트 스레드로 보낼 수 있습니다.

파일 및 프롬프트

파일 트리에서 검색, 파일 유형 아이콘, Finder/Explorer에서 révéler 기능을 제공합니다. 글로벌/작업 공간 프롬프트를 위한 프롬프트 라이브러리를 제공하여 생성/편집/삭제/이동 및 현재 또는 새로운 스레드에서 실행을 지원합니다.

UI 및 경험

크기 조절이 가능한 사이드바/오른쪽/플랜/터미널/디버그 패널을 제공하며, 크기는 지속됩니다. 데스크톱/태블릿/폰에 반응하는 레이아웃과 탭 기반 네비게이션을 지원합니다. 사이드바 사용량과 크레딧 메터를 통해 계정 속도 제한을 표시하고, 홈 사용량 스냅샷을 제공합니다. 여러 탭을 갖춘 터미널 도크를 제공하여 백그라운드 명령 실행(실험적)을 지원합니다. 토스트 기반 다운로드/설치를 통한 앱 내 업데이트, 디버그 패널 복사/지우기, 소리 알림, 플랫폼별 창 효과(macOS 오버레이 타이틀 바 + 바이브란시)와 투명도 감소 토글을 제공합니다.

다운로드·설치 방법

소스 코드에서 빌드하려면 먼저 의존성을 설치해야 합니다:

npm install

개발 모드로 실행하려면 다음 명령을 사용합니다:

npm run tauri:dev

Windows용 프로덕션 빌드는 opt-in이며, 별도의 Tauri 설정 파일을 사용합니다:

npm run tauri:build:win

이 명령은 다음 위치에 아티팩트를 생성합니다:

• src-tauri/target/release/bundle/nsis/ (설치 프로그램 .exe)
• src-tauri/target/release/bundle/msi/ (MSI 설치 프로그램)

Windows에서 소스 코드로 빌드할 때는 bindgen/libclang을 위한 LLVM/Clang과 CMake가 추가로 필요합니다.

기본 사용법

앱을 처음 실행하면 왼쪽 사이드바에서 작업 공간을 추가할 수 있습니다. 작업 공간을 추가한 후 홈 대시보드에서 최근 활동을 확인하거나, 중앙 대화 뷰에서 Codex 에이전트와 상호작용을 시작할 수 있습니다. 메시지를 입력하고 Shift+Ctrl+Enter (Windows/Linux)를 눌러 전송할 수 있으며, 이미지 첨부나 프롬프트 자동 완성을 활용할 수 있습니다. 오른쪽 패널에서는 Git 상태를 확인하고, 커밋 메시지를 입력하거나, 스테이지되지 않은 파일을 관리할 수 있습니다. 상단 메뉴에서 설정에 접근하여 원격 백엔드 토큰, Codex 바이너리 경로, UI 스케일 등을 구성할 수 있습니다.

이런 경우에 유용합니다

여러 Codex 에이전트를 동시에 관리해야 하는 개발자에게 유용합니다. 예를 들어, 서로 다른 기능 브랜치에서 작업 중인 여러 작업 공간을 생성하고, 각 작업 공간에서 에이전트 스레드를 추적하며, Git 변경 사항을 실시간으로 확인하고, PR 컨텍스트를 에이전트에 전달하여 코드 검토나 수정을 요청할 수 있습니다. 파일 트리에서 특정 파일을 빠르게 찾아 에이전트에 컨텍스트를 제공하거나, 저장된 프롬프트를 재사용하여 반복적인 작업을 자동화할 수 있습니다. 터미널 패널을 통해 백그라운드 빌드나 테스트 명령을 실행하면서 메인 인터페이스에서 에이전트와의 대화를 계속할 수 있습니다.

지원 환경·시스템 요구사항

Codex Monitor는 Windows, macOS, Linux에서 실행됩니다. Windows 빌드는 opt-in으로 제공되며, 소스 코드에서 빌드하는 경우 LLVM/Clang과 CMake가 필수입니다. macOS 및 Linux에서는 기본 Tauri 빌드가 지원됩니다. 앱은 Node.js + npm, Rust 툴체인(stable), CMake를 요구하며, dictation/Whisper 기능을 사용하려면 Windows에서 LLVM/Clang이 추가로 필요합니다. Codex CLI가 PATH에 설치되어 있어야 하며, Git CLI는 워크트리 작업에, GitHub CLI(gh)는 이슈/PR 통합에 선택적으로 사용됩니다.

최신 버전·업데이트

현재 버전은 0.7.67이며, 최신 업데이트 정보는 GitHub 저장소의 릴리스 노트에서 확인할 수 있습니다. 앱 내 업데이트 기능은 토스트 기반 다운로드/설치를 통해 제공되며, 디버그 패널에서 복사/지우기 및 소리 알림을 지원합니다.

제한 사항·확인 사항

iOS 지원은 현재 개발 중(WIP)이며, 터미널과 음성 입력(dictation) 기능은 iOS 빌드에서 사용할 수 없습니다. 데스크톱에서의 원격 백엔드 모드 사용 시, iOS 기기와 연결 상태를 유지하기 위해 데스크톱 데몬이 계속 실행되어야 합니다. Windows에서 소스 코드 빌드 시, dictation/Whisper 의존성을 위한 LLVM/Clang이 필수이며, 누설 시 npm run doctor 명령을 통해 진단할 수 있습니다.

화면으로 보는 주요 기능

Codex Monitor 인터페이스

CodexMonitor 애플리케이션의 주 화면을 보여주며, 왼쪽에는 'Projects' 섹션과 'CodexSkillManager', 'draft-day', 'hangtag' 등의 프로젝트 목록이 있습니다. 중앙에는 'CodexMonitor' 프로젝트의 대화 내용이 표시되며, 'Tests are green.'과 같은 테스트 결과 및 'npm run test' 명령어 실행 결과가 포함되어 있습니다. 오른쪽에는 'Commit message…' 입력란과 'UNSTAGED' 파일 목록이 있으며, 'Messages.tsx', 'messages.css', 'types.ts', 'threadItems.ts' 파일의 변경 사항이 표시됩니다. 하단에는 'Ask Codex to do something…' 입력창과 'gpt-5.2-codex', 'medium', 'Full access' 설정 옵션이 있습니다.