OpenAI Codex Desktop Setup Guide
Using Bootspring with OpenAI's Codex Desktop application.
Overview
OpenAI's Codex Desktop is a desktop coding assistant. Bootspring enhances Codex by providing:
- Structured Context - CLAUDE.md provides project understanding
- Expert Guidance - Specialized development patterns
- Production Patterns - Copy-paste ready code snippets
- Workflow Management - Multi-phase development orchestration
Prerequisites
- Codex Desktop installed (openai.com)
- Bootspring CLI installed (
npm install -g bootspring) - Node.js 18+ installed
- OpenAI API key (for Codex Desktop)
Installing Codex Desktop
macOS
Windows
Download from OpenAI's website and run the installer.
Linux
Bootspring Integration
Step 1: Initialize Bootspring
This creates:
CLAUDE.md- Context file (Codex can read this)bootspring.config.js- Configuration.bootspring/- Local data
Step 2: Configure Codex Settings
Codex Desktop reads files in your project. Add CLAUDE.md to indexed files:
- Open Codex Desktop Settings
- Navigate to "Context Files"
- Add
CLAUDE.mdto the list - Enable "Auto-index on change"
Step 3: Create Custom Instructions
In Codex Desktop, set custom instructions:
Refer to CLAUDE.md for complete project context, architecture, and coding standards.
When generating code:
1. Follow patterns defined in project context
2. Use the tech stack specified
3. Match existing code style
4. Consider security best practices
Using Bootspring with Codex
Project Context
Codex reads your CLAUDE.md for context:
Referencing Context
In Codex prompts:
Looking at the project context in CLAUDE.md, create a new API endpoint for user preferences following our established patterns.
Using Bootspring Patterns
Ask Codex to follow Bootspring patterns:
Generate a REST API endpoint following the patterns in my project context.
Include:
- Zod validation
- Error handling
- TypeScript types
Terminal Integration
Using Codex Terminal
Codex Desktop includes a terminal. Use Bootspring directly:
Agent Consultations
Use Bootspring agents for specialized guidance:
Skill Patterns
Apply production patterns:
Workflow Examples
Feature Development
-
Plan with Bootspring
Loading code block... -
Design Phase - Bootspring provides architecture guidance
-
Implement in Codex - Use Codex for code generation
-
Apply Patterns
Loading code block... -
Quality Check
Loading code block...
Code Review
Debugging
Configuration
Bootspring Config
Codex Settings
Configure Codex to work well with Bootspring:
- Context Files: Add
CLAUDE.md,bootspring.config.js - Excluded Files:
node_modules/,.bootspring/ - Custom Instructions: Reference project context
Keeping Context Updated
Manual Update
Git Hook
Watch Mode
Best Practices
Start Conversations with Context
I'm working on [project from CLAUDE.md].
Help me implement [feature] following our patterns.
Reference Specific Sections
According to our Tech Stack (from project context),
we use Prisma for the database. Help me create a migration.
Validate Codex Output
Always validate generated code:
Troubleshooting
Context Not Loading
Codex Not Following Patterns
- Verify custom instructions include context reference
- Explicitly mention patterns in prompts
- Provide specific examples from your codebase
Terminal Commands Failing
Comparison with Other Tools
| Feature | Codex Desktop | Claude Code | Cursor |
|---|---|---|---|
| Context via file | ✓ | ✓ | ✓ |
| MCP integration | - | ✓ | - |
| Inline editing | ✓ | ✓ | ✓ |
| Terminal access | ✓ | ✓ | ✓ |
| Custom instructions | ✓ | ✓ | ✓ |
Next Steps
- Terminal Usage - CLI workflows
- Claude Code Setup - For MCP integration
- VS Code Setup - For IDE integration
- Understanding Context