Codex 워크스페이스 대시보드

내 ~/.codex/ 디렉터리의 지침, 설정, 스킬, 플러그인, MCP 서버, 세션, 히스토리를 한 화면에서 확인하는 읽기 전용 로컬 대시보드입니다.

화면에 편집/저장 버튼이 보여도 ~/.codex 파일은 수정하지 않습니다.

시작하기

python3 server.py

브라우저에서 http://localhost:8080을 엽니다.

또는:

./start.sh

Python 표준 라이브러리만 사용합니다. 별도 패키지 설치가 필요 없습니다.

데이터 소스

카드	Codex 데이터 위치
글로벌 지침	~/.codex/AGENTS.md
설정 / 모델 / 샌드박스 / 승인 정책	~/.codex/config.toml
프로젝트 신뢰 상태	~/.codex/config.toml의 [projects."..."]
MCP 서버	~/.codex/config.toml의 [mcp_servers.*]
플러그인	~/.codex/config.toml + ~/.codex/plugins/cache/
스킬	~/.codex/skills/*/SKILL.md + 플러그인 스킬
에이전트	~/.codex/agents/*.md, ~/.codex/skills/*/agents/*.md, 플러그인 에이전트
세션	~/.codex/sessions/**/*.jsonl + ~/.codex/session_index.jsonl
명령 히스토리	~/.codex/history.jsonl
작업 흔적	~/.codex/ambient-suggestions/

React 번들은 /api/codex-md를 호출하고, 백엔드는 ~/.codex/AGENTS.md를 반환합니다.

Official Reference Map

• AGENTS.md: Codex 프로젝트/글로벌 지침.
• Config basics, Config reference, Sample config: config.toml, 모델, 샌드박스, 승인 정책, 프로젝트 신뢰 설정.
• Sandboxing: read-only, workspace-write, danger-full-access와 승인 정책.
• MCP: [mcp_servers.*] 구성과 CLI/IDE 공통 설정.
• Plugins, Skills: 설치형 확장과 재사용 워크플로우.
• Hooks, Subagents, Automations: 자동화, 검증, 병렬 에이전트 운영.
• Prompting, Workflows: 명확한 완료 기준과 검증 가능한 작업 요청.

안전 동작

• GET /api/*는 로컬 Codex 파일을 읽어서 표시합니다.
• AGENTS.md 생성/수정/삭제 엔드포인트는 실제 파일을 변경하며, 기존 파일은 .bak-YYYYMMDD-HHMMSS로 백업합니다.
• 설정 저장, 일반 파일 쓰기 등 그 외 PUT, 일반 POST, DELETE는 { "ok": true, "readOnly": true }만 반환합니다.
• /api/open-folder만 예외적으로 macOS Finder에서 폴더를 엽니다.
• 폴더 열기는 사용자 홈 디렉터리 하위 경로만 허용합니다.
• auth.json 같은 민감 파일은 읽지 않습니다.

현재 한계

• 프론트엔드 원본 소스는 없고 빌드된 dist/만 있습니다. UI 구조 변경은 dist/assets/index-DYwNDC3K.js를 직접 패치해야 합니다.
• Codex 승인 대기 큐와 자동화 실행 결과는 현재 ~/.codex에 안정적인 공개 파일 형태로 저장되지 않아 일부 카드는 빈 목록으로 표시합니다.
• 디바이스 구분은 기존 화면과 맞추기 위한 cwd 기반 휴리스틱입니다.

검증

python3 -m py_compile server.py
node -c dist/assets/index-DYwNDC3K.js

서버 실행 후 API를 확인하려면:

curl -s http://localhost:8080/api/settings
curl -s http://localhost:8080/api/skills
curl -s http://localhost:8080/api/codex-md