Troubleshooting

Solution:

• •Verify you're on the latest version of Claude Code, Cursor, or your platform
• •Clear browser cache and restart the app
• •Search with exact spelling: "IdeaTwister" (capital T and W)
• •Check your region/account isn't blocked from marketplace access

Solution:

• •Restart the application after attempting install
• •Try manual installation if marketplace install fails (see platform-specific guides)
• •Check you have sufficient disk space (~500MB)
• •Verify internet connection is stable during install

Solution:

• •Restart your AI tool or terminal completely
• •Verify the plugin/extension is listed as "Installed" in Extensions → Manage
• •Check the installation completed without errors (see logs if available)
• •Try the manual installation process (symlink or git clone) for your platform

Solution:

• •Check the symlink exists:
• $ls -la ~/.agents/skills/ideatwister
• •If missing, recreate it (see platform guide)
• •Verify the ~/.ideatwister directory has read/write permissions:
• $chmod -R u+w ~/.ideatwister

Solution:

• •Interrupt the run (Ctrl+C or Cmd+C)
• •Re-run the same command: /ideatwister list
• •IdeaTwister saves checkpoints after each phase and will resume
• •If still stuck after resume, check your network connection (web research phase requires internet)
• •Try again in a few minutes (temporary network issues may have caused the hang)

Solution:

• •Check the terminal/chat output for the dashboard path
• •Verify ~/.ideatwister/runs/ exists and has subdirectories:
• $ls -la ~/.ideatwister/runs/
• •Look for the run slug (e.g., remote-accountant-job-board-2026-04-24)
• •Open the path manually in your browser:
• $open ~/.ideatwister/runs/{slug}/dashboard.html

Solution:

• •This is normal - IdeaTwister is doing a lot of work in parallel
• •Close other applications to free up resources
• •Runs typically use 2–4GB RAM temporarily during phases 3–5
• •If your machine crashes, restart and re-run - it will resume from the last checkpoint

Solution:

• •Run the init script for your platform:
• •For Claude Code: ~/.claude/plugins/ideatwister/scripts/init-store.sh
• •For CLI platforms: ~/.{platform}/ideatwister/scripts/init-store.sh
• •Then restart your app/terminal

Solution:

• •Fix permissions:
• $chmod -R u+w ~/.ideatwister/
• •If that doesn't work, try:
• •sudo chown -R $(whoami) ~/.ideatwister/

Solution:

• •Check the runs exist:
• $ls -la ~/.ideatwister/runs/
• •Run /ideatwister list to see all runs
• •Runs are shared across all platforms - if you switch platforms, past runs should still be visible
• •If runs disappeared, check if they're in a different user directory (multi-user systems)

Solution:

• •Copy the printed path
• •Open it manually:
• $open ~/.ideatwister/runs/{slug}/dashboard.html
• $This usually works on macOS/Linux but may require manual opening on Windows

Solution:

• $Cursor doesn't auto-open browsers. Copy the path from chat output
• •Paste it in your browser address bar:
• •file:///Users/username/.ideatwister/runs/{slug}/dashboard.html

Solution:

• •Verify symlink:
• $ls -la ~/.agents/skills/ideatwister
• •If the symlink is broken (shows red in ls):
• •rm -f ~/.agents/skills/ideatwister
• $ln -s ~/.{platform}/ideatwister/skills/ideatwister ~/.agents/skills/ideatwister
• •Restart terminal

Solution:

• •This is normal if you're offline - pipeline continues without research
• •Check your internet connection
• •Verify your API provider credentials are configured (Claude API key, Google credentials, etc.)
• •Try running again - temporary network issues may have caused failure

Solution:

• •This happens if the web search phase failed (see above)
• •Variations still get scored and should be viable
• •For deeper research, run /ideatwister dive on the top variations