✨

Google Gemini CLI

Google's conversational AI platform. Extract the zip file and run install.sh. Familiar syntax for Google Cloud users.

Prerequisites

  • ✓Gemini CLI installed (gemini command available)
  • ✓Google credentials 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
  • The script auto-detects Gemini CLI and installs everything automatically.

Step 3: Or Install Manually

  • If you prefer manual setup:
  • 1. Run: mkdir -p ~/.agents/skills
  • 2. Run: cp -r /path/to/ideatwister-engine/skills/ideatwister ~/.agents/skills/ideatwister
  • Or use the built-in command: gemini skills install /path/to/ideatwister-engine/skills/ideatwister --scope user
  • 3. Run: mkdir -p ~/.ideatwister/runs
  • 4. Restart Gemini CLI

Verify the Installation

Verify the Installation

  • In Gemini CLI, type:
  • gemini
  • > /ideatwister help
  • You should see the command list. If "skill not found", verify the skill directory: ls ~/.agents/skills/ideatwister

Your First Run

$ gemini > /ideatwister I want to build a niche job board for remote accountants [Gemini runs through all 6 phases...] ✅ 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.

/ideatwister list

List all past runs.

/ideatwister open <slug>

Open the dashboard.

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

Browse variations with optional filtering.

/ideatwister help

Show all available commands.

Known Limitations

  • •Web search: Uses Google's search APIs (available if configured).
  • •Interactive browser open: Not supported. Dashboard path is printed; open manually in your browser.
  • •Subagent parallelization: Gemini CLI doesn't support parallel subagents in terminal mode. Pipeline is sequential.

Troubleshooting

Skill not found

  • Verify the skill directory exists:
  • ls ~/.agents/skills/ideatwister
  • gemini skills list
  • If missing, re-run the installer or copy manually to ~/.agents/skills/ideatwister

Data store not found

  • bash ~/.agents/skills/ideatwister/scripts/init-store.sh

Web search not available

  • Verify Google credentials are configured:
  • gcloud auth application-default login

Permission denied on skills directory

  • chmod -R u+w ~/.agents/skills/ideatwister

Updating

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

Uninstalling

  • rm -rf ~/.agents/skills/ideatwister
  • Your 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. Explore the variations that look promising