šŸ’»

OpenAI Codex CLI

Terminal-native integration. Extract the zip file and run install.sh. CLI-friendly output for scripting and automation.

Prerequisites

  • āœ“Codex CLI installed (codex command available in terminal)
  • āœ“OpenAI API key configured
  • āœ“IdeaTwister zip file (received after purchase)
  • āœ“~30ā€“50 minutes for a full run

Installation

Step 1: Extract the Zip File

Unzip the IdeaTwister file you received. You'll see a folder structure with install.sh and platform-specific files.

Step 2: Run the Install Script (Recommended)

  • Open your terminal and run:
  • cd /path/to/ideatwister-zip
  • ./install.sh
  • When prompted, select Codex CLI as your platform.

Step 3: Or Install Manually

  • If you prefer manual setup:
  • 1. Copy the codex-cli/ folder to ~/.codex/ideatwister
  • 2. Run: mkdir -p ~/.agents/skills && ln -s ~/.codex/ideatwister/skills/ideatwister ~/.agents/skills/ideatwister
  • 3. Run: mkdir -p ~/.ideatwister/runs
  • 4. Restart terminal

Verify the Installation

Verify the Installation

  • codex
  • > /ideatwister help
  • You should see the command list.

Your First Run

$ codex > /ideatwister I want to build a B2B SaaS for accounting automation [Running Phase 1-6...] āœ… Pipeline Complete Variations: 52 High conviction (8+): 8 Time elapsed: 45 minutes Dashboard: ~/.ideatwister/runs/accounting-automation-b2b-2026-04-24/dashboard.html

All Available Commands

/ideatwister <idea>

Run the complete pipeline on your idea.

/ideatwister list

List all past runs.

/ideatwister open <slug>

Open the dashboard (path printed for manual opening).

/ideatwister variations <slug>

Browse all variations.

/ideatwister dive <slug> <variation>

Deep dive analysis on a variation.

/ideatwister help

Show all commands.

Known Limitations

  • ā€¢Interactive browser: Not supported. Dashboard path is printed; open manually in your browser.
  • ā€¢Web search: Available via Codex CLI's native tools.
  • ā€¢Sequential execution: Phases run sequentially (no parallel execution).
  • ā€¢Terminal output: Results stream to terminal; redirect to file if needed.

Troubleshooting

Skill not found error

  • Check the symlink exists:
  • ls -la ~/.agents/skills/ideatwister
  • If not, re-create it:
  • ln -s ~/.codex/ideatwister/skills/ideatwister ~/.agents/skills/ideatwister

codex: command not found

Verify Codex CLI is installed and in your PATH: which codex

Data store not initialized

  • bash ~/.codex/ideatwister/scripts/init-store.sh

Updating

To update, download the latest version from your account and run the install script again, or manually replace the files in ~/.codex/ideatwister

Uninstalling

  • rm -f ~/.agents/skills/ideatwister
  • rm -rf ~/.codex/ideatwister
  • Data in ~/.ideatwister/ is preserved.

Your data in ~/.ideatwister/ is preserved after uninstalling.

Next Steps

  1. Run your first idea through the pipeline
  2. Open the dashboard in your browser
  3. Browse all 50+ variations with scores
  4. Deep dive on the ones that look promising