milisp/codexia

Codexia는 Codex CLI + Claude Code를 위한 Tauri v2 앱입니다. 에이전트 워크플로 (Agent workflows), IDE 스타일의 에디터, 헤드리스 웹 서버 (headless web server), 그리고 프롬프트 메모장을 하나의 워크스페이스 (workspace)에 결합했습니다.

에이전트 워크플로 (Agent workflows): 반복적인 작업을 위한 작업 스케줄러 (Task Scheduler), 헤드리스 웹 서버를 통한 원격 제어
워크스페이스 (Workspace): Git worktree 관리, 프로젝트 파일 트리, IDE 스타일의 에디터, 프롬프트 메모장, 로컬 웹 미리보기
데이터 도구 (Data tools): 클릭 한 번으로 가능한 PDF / XLSX / CSV 미리보기
생태계 (Ecosystem): MCP 서버 마켓플레이스, 에이전트 기술 (agent skills) 마켓플레이스
개인화 (Personalization): 테마 및 액센트 커스터마이징, 사용량 분석 대시보드

brew tap milisp/codexia
brew install --cask codexia

• Codexia를 실행합니다.

• 프로젝트 디렉토리를 추가합니다.

• 프롬프트를 입력하고 에이전트 세션을 시작합니다.

• 반복적인 워크플로를 위해 에이전트 작업 스케줄러 (Agent Task Scheduler) 작업을 생성합니다.

• Codex 앱 서버 (app-server) 통합

• Claude 에이전트 Rust SDK 통합

• 프론트엔드 (Frontend): src/ 내의 React + TypeScript + Zustand + shadcn/ui

• 데스크톱 백엔드 (Desktop backend): src-tauri/src/ 내의 Tauri v2 + Rust

• 헤드리스 백엔드 (Headless backend): 원격 제어를 위한 src-tauri/src/web/ 내의 Axum 웹 서버

• 에이전트 런타임 (Agent runtime): Codex app-server

세션/턴 라이프사이클 (session/turn lifecycle)을 위한 JSON-RPC 통합 - 실시간 업데이트: 브라우저 클라이언트를 위한 /ws 경로의 WebSocket 브로드캐스트 스트림

핵심 엔트리 포인트 (Core entry points):

src-tauri/src/lib.rs (데스크톱 명령 및 상태)
src-tauri/src/web/server.rs (헤드리스 서버 시작)
src-tauri/src/web/router.rs (HTTP API 라우트 표면)
src/services/tauri/ (프론트엔드 인보크 (invoke) 레이어)

Codexia는 웹/헤드리스 모드로 실행될 때 브라우저에서 접근 가능한 API를 노출합니다:

• 상태 확인 및 스트림 (Health and stream):
  GET /health, GET /ws

• Codex 라이프사이클 (Codex lifecycle):
  /api/codex/thread/*, /api/codex/turn/*, /api/codex/model/*, /api/codex/approval/*

• 자동화 스케줄러 (Automation scheduler):
  /api/automation/* (생성/업데이트/목록/실행/일시정지/삭제)

• 파일, Git 및 터미널 (Files, git, and terminal):
  /api/filesystem/*, /api/git/*, /api/terminal/*

• Claude 통합 (Claude integration):
  /api/cc/*

• 노트 및 생산성 (Notes and productivity):
  /api/notes/*, /api/codex/usage/token

기여자 노트 (Contributor note):

• src-tauri/src/web/handlers/ 아래에 새로운 API 핸들러 (API handlers) 추가

• src-tauri/src/web/router.rs에 라우트 (routes) 등록

• src/services/tauri/에 상응하는 프론트엔드 클라이언트 (frontend client) 호출 추가

프로세스 격리 (Process isolation): 에이전트 (Agents)는 별도의 프로세스에서 실행됩니다. 권한 제어 (Permission control): 에이전트별로 파일 및 네트워크 액세스를 구성합니다. 로컬 스토리지 (Local storage): 모든 데이터는 사용자의 기기에 머뭅니다. 오픈 소스 (Open source): 오픈 소스 코드를 통해 완전한 투명성을 제공합니다. 텔레메트리 (Telemetry): 선택 사항이며, 기본적으로 비활성화되어 있습니다.

기여를 환영합니다. 설정 및 워크플로우 (workflow)에 대해서는 CONTRIBUTING.md를 읽어보세요.

커뮤니티 포크 (Community forks):

• jeremiahodom/codex-ui — API/SSE를 포함한 Node.js 백엔드 (backend)
• Itexoft/codexia — SSH 통합 (integration)
• nuno5645/codexia — 추론 (Reasoning) 및 토큰 수 (token count) 이벤트

관련 항목:

• awesome-codex-cli — Codex CLI 리소스 큐레이션 목록
• claw-army/claude-node — Claude Code CLI를 위한 Python 서브프로세스 (subprocess) 브리지

AGPL-3.0 (오픈 소스) 및 상업용 라이선스 (Commercial License) (폐쇄 소스 / SaaS 사용) 하에 이중 라이선스가 적용됩니다.
자세한 내용은 COMMERCIAL.md를 참조하세요.