šŸš€

GitHub Copilot CLI

GitHub's command-line AI tool. Extract the zip file and run install.sh. Works via gh copilot chat and gh copilot suggest.

Prerequisites

  • āœ“GitHub CLI (gh) installed
  • āœ“GitHub Copilot CLI extension (gh extension install github/gh-copilot)
  • āœ“GitHub authentication 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 GitHub Copilot CLI as your platform.

Step 3: Or Install Manually

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

Verify the Installation

Verify the Installation

  • gh copilot chat
  • > /ideatwister help
  • You should see the command list.

Your First Run

$ gh copilot chat > /ideatwister I want to build a tool for remote accountants [Copilot runs through all phases...] āœ… Pipeline Complete! Variations: 50 High conviction (8+): 6 Time elapsed: 40 minutes šŸ“Š Dashboard: ~/.ideatwister/runs/remote-accountant-tool-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>

Browse all variations.

/ideatwister dive <slug> <variation>

Deep dive on a specific variation.

/ideatwister help

Show all available commands.

Known Limitations

  • ā€¢Browser open: Not supported. Dashboard path is printed; open manually.
  • ā€¢Web search: Available through Copilot's native tools.
  • ā€¢Sequential execution: Pipeline runs sequentially.
  • ā€¢Terminal-first: Output is optimized for terminal display.

Troubleshooting

Skill not found

  • Verify the symlink exists:
  • ls -la ~/.agents/skills/ideatwister
  • If not found, recreate it:
  • ln -s ~/.agents/ideatwister/skills/ideatwister ~/.agents/skills/ideatwister

Data store not found

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

Copilot CLI extension not found

  • gh extension install github/gh-copilot

GitHub authentication failed

  • gh auth login

Updating

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

Uninstalling

  • rm -f ~/.agents/skills/ideatwister
  • rm -rf ~/.agents/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