Codex Command Center
Turn Codex sessions into organized engineering work.
Codex Command Center is a Windows-first, local-first desktop workspace for organizing Codex-based engineering work across projects, tasks, sessions, Git changes, Skills, and MCP configuration.
Codex does the reasoning, editing, commands, and tests. Codex Command Center keeps the surrounding engineering workflow understandable and resumable.
Overview
Heavy Codex usage can leave useful context spread across:
- local repositories;
- engineering objectives;
- Codex session history;
- staged and unstaged Git changes;
- local Skills;
- MCP configuration.
Codex Command Center connects those pieces into one focused workflow:
Project -> Task -> Codex Session -> File Changes -> Result
The app is intentionally smaller than an IDE, terminal emulator, chat client, or advanced Git GUI. It is an organizing layer for local Codex work.
Screenshots
| Dashboard |
Projects and tasks |
 |
 |
| Sessions |
Git changes |
 |
 |
| Codex environment |
 |
Core features
- Project organization: register local development folders and see branch, Git state, task counts, and recent activity.
- Task tracking: organize engineering objectives with Planned, Active, Completed, and Blocked statuses.
- Codex session discovery: index local Codex session metadata without mutating Codex session files.
- Session workflows: link sessions to tasks, launch Codex for a task, and resume selected sessions through the local Codex CLI.
- Git review: inspect branch, staged files, unstaged files, working-tree state, and per-file diffs; stage, unstage, and commit focused changes.
- Codex environment visibility: show detected Codex CLI path/version, redacted local configuration previews, discoverable Skills, and MCP server summaries.
- Local-first storage: keep projects, tasks, session links, and settings on the local machine.
Typical workflow
Add a repository
-> create or select an engineering task
-> launch or resume Codex work
-> review indexed sessions
-> inspect Git changes
-> continue, complete, or block the task
Local-first behavior
The app stores its own state as local JSON under the user's local application data directory. Registered projects are path references; Codex Command Center does not copy project source code into application storage.
The native layer reads local Codex session metadata, local Codex configuration files, local Skills folders, local MCP configuration, and Git status for registered projects. Configuration previews redact lines that appear to contain keys, tokens, secrets, or passwords.
The project does not add telemetry, analytics, accounts, cloud synchronization, source-code upload, Codex-session upload, or Git-diff upload. The app can still invoke external local tools such as codex and git; those tools have their own behavior and configuration.
Requirements
- Windows 11 is the primary supported platform.
- Git on
PATH for Git review.
- Codex CLI on
PATH for launch and resume actions.
- Node.js 24 is the validated source-development and production-build version; Rust and Cargo are also required for native builds.
Installation
Windows binaries are available from GitHub Releases.
- NSIS setup executable: recommended for most Windows users. This is the normal interactive installer.
- MSI installer: useful for users or environments that prefer MSI-based installation or deployment.
- Standalone executable: can run directly without a normal installer.
Windows release binaries are currently unsigned. Source-build instructions remain in the Development and Build sections below.
Development
Install dependencies:
npm ci
Run the browser development surface:
npm run dev
Run the desktop app:
npm run tauri:dev
Run the frontend production build:
npm run build
Run the lightweight tracked-file secret scan:
npm run check:secrets
Build
Build the desktop application:
npm run tauri:build
For native checks when Cargo is available:
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo check --manifest-path src-tauri/Cargo.toml
cargo test --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets --all-features -- -D warnings
Architecture
- Frontend: React and TypeScript under
src/.
- Desktop shell: Tauri 2 configuration under
src-tauri/.
- Native commands: Rust commands for local filesystem, process launch, Git, Codex session indexing, Skills discovery, and MCP configuration summaries.
- Storage: local JSON state under the user's local application data directory.
- Codex integration: local Codex CLI detection plus launch/resume commands.
- Git integration: local Git CLI calls for branch, status, diff, stage, unstage, and commit operations.
Relationship to CodMate
Codex Command Center evolved from the open-source CodMate project by Loocor. Upstream work is acknowledged, and applicable Apache-2.0 licensing and attribution are preserved in LICENSE, NOTICE, and THIRD-PARTY-NOTICES.md.
This project has been substantially refocused and reworked around a Windows-first, Codex-centric workflow for projects, tasks, sessions, and Git changes. It should not be described as built entirely from scratch.
Contributing
See CONTRIBUTING.md.
Use Issues for bugs and focused feature requests, Discussions for questions, workflow ideas, and general feedback, and Security for private vulnerability reports.
Security
See SECURITY.md.
Roadmap
See ROADMAP.md.
Release notes
Release notes for v0.1.1 are available under docs/releases/v0.1.1.md. Earlier release notes remain under docs/releases/ and on the GitHub Releases page.
License
Codex Command Center is distributed under the Apache License 2.0.
Disclaimer
Codex Command Center is an independent open-source project and is not an official OpenAI product. OpenAI, Codex, and related marks belong to their respective owners.
Codex Command Center 是一个 Windows 优先、本地优先的桌面工作区，用来组织基于 Codex 的工程工作：项目、任务、Codex 会话、Git 变更、Skills 和 MCP 配置，全部集中在一处。