🤖

Claude Code

The recommended way to run IdeaTwister. Extract the zip file you purchased and run the install script in 2 minutes, zero configuration needed.

Prerequisites

  • ✓Claude Code installed and running
  • ✓Active Claude subscription (or Claude Code membership)
  • ✓IdeaTwister zip file (received after purchase)
  • ✓~30–50 minutes for a full run (can be interrupted and resumed)

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 Claude Code as your platform.

Step 3: Or Install Manually

  • If you prefer manual setup:
  • 1. Copy the claude-code/ folder to ~/.claude/plugins/ideatwister
  • 2. Run: mkdir -p ~/.ideatwister/runs
  • 3. Restart Claude Code

Verify the Installation

Verify the Installation

  • In a Claude Code chat, type:
  • /ideatwister help
  • You should see the command list. If the command isn't recognized, try restarting Claude Code.

Your First Run

You: /ideatwister I want to build a niche job board for remote accountants Claude: 🎬 IdeaTwister - Idea Mutation Engine Loading orchestrator... ✅ Data store initialized: ~/.ideatwister/runs/ ✅ Deriving slug: remote-accountant-job-board-2026-04-24 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Phase 1/6: Idea Enrichment ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Expanding your idea into a structured brief... ✅ Brief saved [Phases 2-6 continue automatically...] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Pipeline Complete! ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Variations: 51 High conviction (8+): 7 Top score: 9/10 Time elapsed: 42 minutes 📊 Dashboard: ~/.ideatwister/runs/remote-accountant-job-board-2026-04-24/dashboard.html

All Available Commands

/ideatwister <idea>

Run the full pipeline on a raw business idea. Example: /ideatwister I want to build a freelance invoicing tool

/ideatwister list

Show all past runs with dates, scores, and variation counts.

/ideatwister open <slug>

Open the HTML dashboard in your browser. If only one run exists, you can omit the slug.

/ideatwister variations <slug> [--min-score 8] [--strategy 01] [--top]

Browse all 50+ variations. Optional filters: --min-score (show high conviction only), --strategy (filter by lens), --top (show only top picks).

/ideatwister dive <slug> <variation>

Run a focused 4-phase deep dive analysis on a single variation. Takes 15–20 minutes.

/ideatwister help

Show all available commands and syntax.

Known Limitations

  • •Web search: Always available via Claude's native tools.
  • •Browser open: Dashboard opens automatically on macOS/Linux. On Windows, you may need to open the path manually.
  • •Interrupted runs: You can pause and resume. Run the same command again; it checks state and continues from where it left off.
  • •Large token usage: A full run (50+ variations) is intensive. Allow 30–50 minutes and ensure Claude Code doesn't time out.

Troubleshooting

Command not found: /ideatwister

Restart Claude Code after installing. If still not found, verify the plugin installed in Extensions → Manage Extensions. IdeaTwister should show as "Installed".

Run seems stuck

Interrupt the run (Cmd+C or Ctrl+C in the chat). Then re-run the same command. IdeaTwister saves checkpoints after each phase and will resume.

Dashboard doesn't open automatically

The path is printed in the chat. Copy it and manually open in your browser: open ~/.ideatwister/runs/{slug}/dashboard.html

Permission denied on ~/.ideatwister/

Fix permissions: chmod -R u+w ~/.ideatwister/

Updating

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

Uninstalling

  • rm -rf ~/.claude/plugins/ideatwister
  • Your data in ~/.ideatwister/ is preserved after uninstalling.

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