PlanToCodeDesktop workspace for Codex CLI
PlanToCode wraps Codex CLI in a desktop app so you can chat with Claude Code, capture rich context with Gemini video analysis, generate and review implementation plans, and monitor background jobs across projects — with an iOS companion to continue sessions from your phone.
This site is the front page for the PlanToCode repository. Browse the code, docs, and architecture from here.
Desktop workflow overview
A walkthrough of the Codex CLI desktop workspace — from Claude Code chat and implementation planning to background job monitoring.
- Chat with Claude Code through Codex CLI in a desktop UI
- Browse 48+ reusable skills and drag them into chat as prompt context
- Generate, review, and merge implementation plans across models
- Monitor background jobs across projects with token usage and cost tracking
Review before execution
Review plans before execution, track chat sessions and background jobs, and keep a full audit trail in SQLite.
File-by-file plans with exact paths
Implementation plans break down changes by file and operation so scope is explicit before anything runs.
Review, edit, approve
Review and edit plans on desktop or mobile before execution. Every chat session and job output is stored for audit.
Execution handoff
Approved plans are handed to Codex CLI or the integrated terminal with full context. Logs stay in the app.
What the desktop app does
Chat with Claude Code through Codex CLI, capture rich context with Gemini video analysis, generate implementation plans, and monitor background jobs — with optional reusable skills.
Desktop workflow overview
A walkthrough of the Codex CLI desktop workspace — from Claude Code chat and implementation planning to background job monitoring.
- ✓Chat with Claude Code through Codex CLI in a desktop UI
- ✓Browse 48+ reusable skills and drag them into chat as prompt context
- ✓Generate, review, and merge implementation plans across models
- ✓Monitor background jobs across projects with token usage and cost tracking
Multi-model plan drafts
Run the same task through multiple models and compare drafts before merging or execution.
- ✓Plan jobs include selected file contents + directory tree
- ✓Explicit file operations with exact paths
- ✓Structured plan metadata captured per draft
- ✓Merge prompt uses <source_plans> and <user_instructions>
- ✓Final plan stored alongside source drafts
Plan merge instructions
Provide merge guidance, keep source traceability, and store the merged plan alongside its inputs.
- ✓Source plans pulled by job ID
- ✓Merge instructions stored in metadata
- ✓File contents + directory tree add context
- ✓Merged plan stored alongside inputs
- ✓Mobile voice dictation for merge instructions
Codex CLI chat
The app wraps Codex CLI and reads its JSONL output to render a live chat timeline. You talk to Claude Code through a desktop UI with streaming, session persistence, and configurable access modes.
- ✓Codex CLI spawned and managed by the Rust backend
- ✓JSONL timeline parsed and rendered in real time
- ✓Configurable access modes (read-only, full-auto, full-access)
- ✓Context window tracking with token usage reporting
Screenshot coming soon
Updated UI screenshot in progress
File Discovery Pipeline
A four-stage Rust workflow: LLM-assisted root selection, regex filtering, relevance scoring, and extended path finding to build a focused file set.
- ✓Root folder selection uses the directory tree and task prompt
- ✓Regex filter generates pattern groups and applies git ls-files
- ✓Relevance scoring chunks file contents with token estimates
- ✓Extended path finder expands context with file + tree data
Skills catalog
Browse 48+ reusable skills and drag them into Codex CLI chat as prompt context. Skills are templates stored in the repo that add structure to your conversations.
- ✓Repository-local and external skill catalogs
- ✓Drag-and-drop skills into chat prompts as context
- ✓Trust levels and verification status per skill
- ✓Side-by-side skill comparison and source viewer
Screenshot coming soon
Updated UI screenshot in progress
System prompts and model control
See and edit system prompts, choose models per task, and understand exactly what is sent.
- ✓Per-task allowed models and defaults
- ✓System prompts served by the server API
- ✓Project-level prompt overrides in project_system_prompts
- ✓Local key_value_store for runtime preferences
Background Jobs Sidebar
Multi-project job monitoring sidebar with project groups, detailed panels showing system prompts, responses, errors, model config, and cost breakdown.
- ✓Project-grouped job cards with status, progress, and timing
- ✓Detailed panels with system prompt, response, and error views
- ✓Token usage and cost tracking per job and per project
- ✓Job filtering, history clearing, and terminal output modals
Screenshot coming soon
Updated UI screenshot in progress
Gemini video analysis for rich context
Record your screen or upload videos — Gemini's multimodal analysis extracts UI details, workflows, and bugs into structured summaries you can feed directly into Codex CLI chat or implementation plans.
- ✓Multimodal analysis of screen recordings, design reviews, and bug walkthroughs
- ✓Gemini processes video with a focus prompt to extract relevant context
- ✓Analysis summaries attach to task descriptions for richer Codex conversations
- ✓Usage and cost tracked per analysis job
Usage and Cost Ledger
Server-side usage entries and job metadata capture model usage across providers.
- ✓Per-job token and cost metadata
- ✓Provider-aware usage entries
- ✓Billing endpoints expose usage summaries
- ✓Usage history for model spend
Ready to use Codex CLI with a full desktop workspace?
Download the desktop app for Claude Code chat, implementation planning, reusable skills, and background job monitoring.
Transparency and control
System prompts, source code, and self-hosting details are visible and documented.
System prompts you can read
Default system prompts and skill templates are stored in the repo and server database so you can inspect and override them per project.
Prompt types docs ->Source available (BSL 1.1)
The full system is on GitHub under the Business Source License so you can audit the architecture.
View GitHub repo ->Self-hosting and BYOK
Run the server yourself to control provider routing and supply your own API keys.
Server setup guide ->Workspace and workflow questions
Common questions about the Codex CLI workspace, planning pipeline, and execution.