CodexMonitor — Codex 에이전트 오케스트레이션 데스크톱 앱

고정 커밋 dd61b9ab…(main HEAD와 일치 확인) 기준 정적 검사 요약. 빌드·테스트는 실행하지 않았고 기능 서술은 README·AGENTS.md(원본 캡처)에 근거한다.[unverified]

개요

CodexMonitor는 Dimillian(Alexis Aubry / Thomas Ricouard — IceCubesApp 등 macOS 생태계로 잘 알려진 개발자)이 만든 Codex 에이전트 오케스트레이션 데스크톱 앱이다. 여러 로컬 워크스페이스의 Codex 세션을 하나의 사이드바·홈 화면·대화 뷰로 통합 관리하며, Codex의 app-server 프로토콜(stdio 구동) 위에 UI를 얹는다. 헤드리스 데몬(codex_monitor_daemon)으로 다른 머신에서 Codex를 원격 실행하고, iOS 클라이언트(WIP)로 원격 접속도 지원한다.[1][2]

핵심은 “여러 Codex 에이전트를 로컬 워크스페이스 단위로 동시에 다룬다”는 점 — 각 워크스페이스마다 codex app-server를 하나씩 띄우고, 스레드 재개·읽음/실행 상태 추적·worktree/clone 에이전트·중단/인터럽트를 UI에서 직접 제어한다.[1]

주요 기능

워크스페이스 & 스레드 — 워크스페이스 추가·영속·그룹/정렬, 홈 대시보드에서 최근 활동 점프. workspace당 codex app-server 스폰, 스레드 resume, unread/running 상태 추적. worktree/clone 에이전트로 격리 작업(legacy .codex-worktrees도 지원). 스레드 pin/rename/archive/copy, 드래프트, 실행 중 턴 중단.[1]
컴포저 & 에이전트 제어 — 이미지 첨부(피커·드래그·붙여넣기), 실행 중 follow-up 동작 Queue vs Steer 설정, macOS Shift+Cmd+Enter/Win·Linux Shift+Ctrl+Enter로 단일 메시지 반대 동작 전송. 스킬($)·프롬프트(/prompts:)·리뷰(/review)·경로(@) 자동완성. 모델 피커·협업 모드·reasoning effort·access mode·context 사용량 링.[1]
Git & GitHub — diff 통계, staged/unstaged diff, revert/stage, 커밋 로그. 브랜치 목록·checkout/create·ahead/behind 카운트. gh로 GitHub Issues/PR 목록·diff·댓글, 브라우저에서 커밋/PR 열기. PR 컴포저의 “Ask PR”로 PR 맥락을 새 스레드로 전송.[1]
파일 & 프롬프트 — 검색·아이콘·Reveal in Finder/Explorer 파일 트리. 전역/워크스페이스 프롬프트 라이브러리(생성/편집/삭제/이동, 현재·신규 스레드 실행).[1]
UI & 경험 — 사이드바/우측/플랜/터미널/디버그 패널 크기 영속, 반응형(데스크톱/태블릿/폰) 탭 네비, 사용량·크레딧 미터, 실험적 멀티탭 터미널 dock, 토스트 업데이트·사운드 알림·플랫폼별 창 효과(macOS vibrancy)·투명도 토글.[1]
원격 백엔드 — 데몬 모드로 다른 머신에서 Codex 실행, Tailscale 감지/호스트 부트스트랩(TCP 모드) 셋업 헬퍼. iOS는 기본 원격 백엔드 모드.[1]

아키텍처 (정적 검사)

Tauri 2 데스크톱 앱: 프론트엔드 src/(React + Vite), 백엔드 앱 src-tauri/src/lib.rs(Tauri Rust 커맨드 레지스트리), 백엔드 데몬 src-tauri/src/bin/codex_monitor_daemon.rs(JSON-RPC 프로세스), 공유 도메인 로직 src-tauri/src/shared/*(git_ui_core, workspaces_core).[2]
설계 원칙(AGENTS.md): 공유/도메인 백엔드 로직은 shared/* 우선, app/daemon은 shared cores의 얇은 어댑터, app↔daemon 중복 금지, JSON-RPC 메서드명·페이로드 형상 안정성, 프론트 IPC 계약↔백엔드 커맨드 표면 동기화.[2]
통신: Codex와는 codex app-server를 stdio로 구동(workspace당 1개). 프론트 IPC 래퍼 src/services/tauri.ts가 백엔드 커맨드에 매핑. IPC surface는 settings/workspaces/worktrees/threads/account/models/git/github/prompts/terminal/dictation/remote backend(Tailscale) 영역 포괄.[1]
데스크톱 외: iOS(WIP, Rust 타깃 aarch64-apple-ios), 헤드리스 데몬 daemonctl(상태/시작/정지/command-preview, --data-dir·--listen·--token 오버라이드), Windows 빌드 opt-in(별도 Tauri conf).[1]
의존성: Node.js+npm, Rust stable, CMake(네이티브·Whisper dictation), LLVM/Clang(Windows bindgen), codex CLI in PATH, gh(선택).[1]

버전·라이선스·출처

라이선스: MIT (LICENSE, 1,072 bytes).[3]
버전: 체크아웃 0.7.68(package.json·Cargo.toml 일치)이나 최신 릴리스 태그는 v0.7.67(2026-03-24) 로 미릴리스 커밋이다. pushed_at은 2026-03-26으로, 수집 시점(2026-08-23) 기준 약 5개월간 푸시가 없었다 — 저장소 활동 정체 가능성 있음(관측값, 저자 다른 프로젝트에 집중 중일 수 있음).[3][4]
수집 시점 관측값: stars 4,249 · forks 405 · TypeScript · homepage https://www.codexmonitor.app · created 2026-01-11 · topics ai/codex/linux/macos/tauri-app.[3]

정적 검사 한계

빌드(npm run tauri:build/cargo check)·테스트·실제 Codex 연동을 실행하지 않았다. 기능 동작은 README·AGENTS.md 서술에 의존하며 confidence: medium.
README 원본의 후행 공백 1행(236행)을 빈 줄로 정규화해 캡처했다(원본 바이트 훼손 방지, raw 파일 frontmatter에 정규화 사실 기록). 본문 SHA는 정규화 후 기준.

Sources

[1] https://github.com/Dimillian/CodexMonitor — README (고정 커밋 dd61b9ab…, 원본 캡처: raw/articles/2026-08-23-github-dimillian-codexmonitor.md) [2] https://github.com/Dimillian/CodexMonitor — AGENTS.md (아키텍처·비핵심 원칙) [3] https://api.github.com/repos/Dimillian/CodexMonitor — GitHub REST API (stars/forks/license/homepage/created/topics/pushed_at, 2026-08-23 수집) [4] https://api.github.com/repos/Dimillian/CodexMonitor/releases/latest — 릴리스 태그 v0.7.67

description	Dimillian의 Tauri 2 데스크톱 앱 — 여러 로컬 워크스페이스의 Codex 에이전트를 app-server 프로토콜로 통합 관리하고, 헤드리스 데몬·iOS 클라이언트로 원격 실행도 지원.
tags	ai-coding, codex, dev-tools, tauri, desktop-agent
aliases	CodexMonitor, codexmonitor

LLM Wiki

탐색기