shanggqm/codexU

codexU – 로컬 AI 사용량 대시보드 및 리더십 점수

소개

• macOS(메뉴바 + 데스크톱) 및 Windows x86_64용 네이티브 애플리케이션으로, OpenAI Codex(및 사용 가능한 경우 Claude Code)가 생성한 로컬 데이터 파일을 읽어 실시간 할당량, 토큰 사용량, 작업 상태 및 독점적인 AI 리더십 점수를 보여줍니다.
• 모든 처리는 로컬 기기에서 이루어지며, 사용량, 스레드, 경로 또는 계정 데이터가 외부 서비스로 전송되지 않습니다.

주요 기능

기능	설명
할당량 개요	Codex의 5시간 및 7일 윈도우에 대한 남은 비율과 초기화 시간(macOS에서 Claude Code가 있는 경우 함께 표시).
토큰 통계	일일, 7일 및 누적 토큰 수(캐시 쓰기, 캐시 히트, 출력 토큰별 분류).
AI 리더십 점수	0-100 등급(7개 배지 레벨). 단순 토큰 수가 아닌, 로컬에서 검증 가능한 에이전트 수명 주기, 부모-자식 관계, 동시성 및 자율 실행 증거를 기반으로 산출.
작업 보드	오늘의 Codex/Claude 작업을 상태, 워크스페이스, 타임스탬프 및 다음 자동화 실행 시간과 함께 나열.
사용 추세	일일 토큰 사용량 히트맵, 모델별 영역 차트(상위 8개 모델 + “기타”), USD 기준 예상 API 비용.
프로젝트 및 도구 순위	가장 많은 토큰/스레드를 소비하는 프로젝트, 도구 및 “Skills”를 표시.
사용자 지정 UI 테마	6가지 내장 컬러 팔레트(예: “青花瓷”, “敦煌飞天”) 및 커뮤니티 승인 팔레트(모두 “Liquid Glass” 갤러리에서 미리보기 가능).
메뉴바 위젯	3가지 투명도 모드(미니멀, 클래식, 리치)를 지원하는 컴팩트한 런타임 뷰(사용량, 남은 할당량 또는 둘 다 표시 가능).
크로스 플랫폼	macOS 13+(Apple Silicon 및 Intel) 및 Windows 10/11 x86_64 빌드(Tauri 사용).
개인정보 보호 업데이트	GitHub 새 릴리스 자동 확인(선택 사항), 백그라운드에서 자동으로 다운로드하거나 설치하지 않음.

작동 방식

• ~/.codex/(macOS) 또는 %USERPROFILE%\.codex\(Windows)의 SQLite 사용 데이터베이스, rollout JSONL 파일 및 자동화 TOML 파일을 읽습니다.
• Claude Code가 설치된 경우 ~/.claude/의 트랜스크립트 JSONL 파일과 작업 JSON 파일도 읽습니다.
• 토큰 이벤트를 집계하고, 모델 귀속을 추론하며, 현재 OpenAI 가격 페이지를 사용하여 비용을 추정하고 UI에 반영합니다.
• 리더십 점수는 내장된 ScoreModel v1.3에 의해 계산되며, 검증 가능한 에이전트 수명 주기와 동시성 증거만 카운트합니다.

설치

• macOS: 최신 GitHub 릴리스에서 적절한 DMG(codexU-<version>-mac-arm64.dmg 또는 -mac-x86_64.dmg)를 다운로드하여 codexU.app을 응용 프로그램 폴더로 드래그한 후, 첫 실행 시 시스템 설정 → 개인정보 보호 및 보안에서 앱을 허용하세요.
• Windows: MSI 또는 NSIS 설치 프로그램(codexU-<version>-windows-x86_64.msi / .exe)을 다운로드하여 실행하고 마법사를 따르세요. Windows 빌드는 현재 Codex 데이터만 지원합니다.
• 소스에서 빌드: make build(macOS는 Xcode 명령줄 도구 필요). make run, make install 또는 make release를 사용하여 DMG/설치 프로그램 패키지를 생성하세요.

기본 사용법

• ⌘ + U(또는 설정된 단축키)를 눌러 메인 창을 전환합니다.
• 메뉴바 아이콘에서 Runtime 메뉴를 열어 Codex와 Claude 뷰를 전환하거나 설정을 열고 종료할 수 있습니다.
• 설정에서 언어, 외관(라이트/다크/자동), 메뉴바 표시 지표, 자동 업데이트 확인 여부를 선택할 수 있습니다.
• AI Leadership 패널은 배지, 진행률 링 및 지난 28일간의 4가지 핵심 지표(에이전트, AI 시간, 최대 동시성, 점수)를 보여줍니다.

대상 사용자

• Codex(또는 Codex CLI)를 정기적으로 사용하며 남은 할당량과 토큰 소비량을 빠르게 확인하려는 개발자.
• Claude Code를 함께 사용하여 두 서비스를 한곳에서 관리해야 하는 팀.
• ChatGPT Pro/Team 플랜을 사용하며 브라우저를 열지 않고 일일/주간 사용량을 모니터링하려는 사용자.

라이선스

• MIT License (LICENSE 참조).

---

위의 모든 세부 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.