Codex Session Manager Rewritten in Rust: Building a Local AI Programming Workstation

lyc-aon/codex-session-manager is a Linux-native Codex-compatible session manager written in Rust. It aims to achieve 1:1 functional parity with the OpenAI Codex CLI while offering a local-first architecture, stronger performance, and richer control capabilities. Core features include session management and persistence, terminal workstation UI, model runtime integration, tool execution orchestration, and secure sandboxing, providing a local AI programming solution for developers seeking privacy, performance, and controllability.

With the release of the OpenAI Codex CLI, issues related to reliance on cloud services have emerged. This project is not a binary clone; instead, it is built based on OpenAI's public APIs, Codex's public behaviors, and open-source code. Its goal is to achieve "observable 1:1 functional parity" while optimizing long-session performance (such as limiting hot context, fast recovery, deterministic replay, etc.) to address the performance bottlenecks of the native Codex.

Rust was chosen for its memory safety guarantees, zero-cost abstractions, and excellent concurrency handling capabilities, making it suitable for scenarios involving event logging, PTY interactions, and real-time UI updates. The project uses a layered architecture design, from the underlying event storage to the top-level terminal application, ensuring modularity and testability.

Session Management and Persistence

• Append-only event logs ensure data integrity
• Sparse indexing supports fast recovery
• Session branching and recovery features
• Replay seed compression for optimized storage

Terminal Workstation

• Headless rendering and ASCII snapshot serialization
• Command palette supports multiple operations

Model and Tool Integration

• Typed GPT-5.5 request construction
• SSE stream parsing and event log projection
• Tool scheduler and round-robin orchestration

Security Sandbox

• Bubblewrap process isolation
• Approval/execution policies
• Fine-grained file system control

The project validates interaction parity through human-simulated end-to-end tests, covering aesthetics, animations, stability, and performance. Quality gates include:

• CI index recovery performance benchmarks (60k event fixture tests)
• Offline adjustment process E2E tests
• Deterministic terminal application tests
• Real-time terminal feature coverage (raw mode, window resizing, etc.)

Compared to the OpenAI Codex CLI, this project offers:

• Local-first: Data is stored locally by default, supporting offline work
• Deterministic replay: Precisely reproduces session states for easy debugging
• Fine-grained control: Configuration options like approval policies and sandbox modes
• Performance optimization: Rust implementation and sparse indexing improve long-session performance
• Open-source and auditable: Complete code supports security reviews and customization

Applicable Scenarios

• Local AI development environments
• Privacy-sensitive scenarios (code not uploaded to the cloud)
• Long-term project maintenance (historical session management)
• Toolchain integration
• Research and experimentation

Current Status and Roadmap

The project is in active development, with core infrastructure already implemented. Future plans include:

• Visual and animation optimizations
• Expanded MCP support
• Integration with more models (Anthropic Claude, Google Gemini, etc.)
• Improved concurrent tool execution
• Plugin ecosystem

lyc-aon/codex-session-manager represents an open-source, local-first AI tool development paradigm. While respecting the original design, it provides users with more control and customization space. For developers seeking performance, privacy, and auditability, it is an attractive alternative and is expected to become an important infrastructure in the field of local AI-assisted programming.