Codex Manager is a desktop configuration and asset manager for OpenAI Codex. It edits and organizes on-disk Codex files with a safety-first flow (diff preview, backups, atomic writes), surfaces local session history from CODEX_HOME, and includes an in-app Codex chat runner with optional terminal access for advanced workflows.

• Config editor with Simple (root scalars), Advanced (nested values), and raw TOML modes.
• Diff preview before every change (stacked/unified view), plus automatic backups and restore.
• Public Config Library with curated presets and apply previews.
• My Configs: save personal presets and apply them later.
• MCP Servers: toggle enabled state and add/update tables.
• Skills: browse user/repo scopes, edit SKILL.md and text files, create/delete skills.
• Public Skills (Clawdhub): search registry, preview SKILL.md/files, install via overlay/replace/sync.
• Diagnostics panel for parse errors and missing paths.
• Settings for CODEX_HOME, repo roots, Codex usage snapshot (plan + rate limit windows + auth status), and local session analytics + wrapped summary from CODEX_HOME logs.
• Chats: searchable session history (pin/archive), transcript paging, copy full ID + resume command, and a new chat workflow that can write workspace-scoped overrides to .codex/config.toml on copy.

• Windows 10/11 (x64): NSIS + MSI installers.
• macOS 14+ (arm64 + x64): DMG + app bundle (unsigned; Gatekeeper will warn on first open).
• Linux (x64): AppImage + .deb + .rpm.

Release builds are produced via GitHub Actions; download installers from Releases.

• Node.js 18+ (20+ recommended)
• Rust toolchain (stable) via rustup
• Tauri system dependencies (platform specific)
  • Windows: Visual Studio Build Tools (Desktop development with C++), WebView2
  • macOS: Xcode Command Line Tools
  • Linux: GTK/WebKit packages (see Tauri prerequisites)

Tauri prerequisites: https://v2.tauri.app/start/prerequisites/

npm install

For installing and using the app, download the installer from the GitHub Releases page.

npm run tauri dev

This is useful for UI iteration, but backend commands will not work.

npm run dev

Use the bundle formats that match your OS:

Windows:

npm run tauri build -- --bundles nsis,msi

macOS:

npm run tauri build -- --bundles dmg,app

Linux:

npm run tauri build -- --bundles appimage,deb,rpm

Windows installers require NSIS + WiX.

cargo test --manifest-path src-tauri/Cargo.toml

Includes:

• TOML patching (scalar edits + MCP toggle)
• Backup/restore round trip (text + binary)
• Path traversal protection
• Skills scan + folder categorization
• Public skill zip planning (overlay/replace/sync)

1. Open Settings and set CODEX_HOME (or ensure the CODEX_HOME env var is set).
2. Add any repo roots that contain .codex/skills for repo-scoped skills (also enables workspace defaults in Chats).
3. Return to Dashboard and click "Refresh scan" if needed.

Canonical sources of truth are on disk:

• CODEX_HOME/config.toml
• CODEX_HOME/skills/**
• REPO_ROOT/.codex/skills/**
• CODEX_HOME/prompts/**
• CODEX_HOME/rules/*.rules
• CODEX_HOME/sessions/** (read-only history)
• WORKSPACE/.codex/config.toml (workspace-scoped overrides from Chats)

All writes follow the same safety rails:

1. Preview a diff.
2. Create a backup.
3. Atomic write.
4. Re-validate and show status.

• Dashboard: view health and diagnostics, load config quickly.
• Config: edit root scalar keys, advanced nested values, or raw TOML with diff preview.
• Public Config Library: apply curated public configs (diff + backup).
• My Configs: save your own presets (stored in app data) and apply them to config.
• MCP Servers: toggle enabled, add/update server tables.
• Skills: view user and repo skills, edit SKILL.md, create or delete skills.
• Public Skills (Clawdhub): browse/search the Clawdhub registry, preview SKILL.md and files, then install via overlay/replace/sync.
• Backups: review, restore, or delete snapshots.
• Chats: review local sessions, pin/archive, copy resume command, and start new chats with workspace defaults.

Public presets live in src/features/config/data/publicConfigs.ts. Add new entries there to ship more curated configs in the Public Config Library.

User-created presets are stored in the app data directory under user-configs/.

• src-tauri/ Rust backend (file ops, diffing, backups, TOML patching)
• src/ React frontend
  • features/ feature-first UI modules
  • components/ shared UI primitives
  • layouts/ app shell + chrome
  • store/ shared state + backend actions

• Raw config editors and previews show full values; handle secrets with care.