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