IdeaTwister for OpenCode

Open-source AI assistant platform. Extract the zip file and run install.sh. Great for community-driven workflows.

Prerequisites

• OpenCode installed and configured
• A provider API key set for IdeaTwister (Gemini, Anthropic, or OpenAI) - see Provider Setup. You bring your own key and pay the provider directly.
• Python 3.10 or newer on your PATH - the installer checks this for you.
• IdeaTwister zip file (received after purchase)
• 5 to 50 minutes for a run, depending on the depth mode you pick

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)

cd /path/to/ideatwister-zip
./install.sh

The script auto-detects OpenCode and installs everything automatically.

Step 3 - Or install manually

OpenCode auto-discovers skills from standard paths - no config file needed. Pick one:

Global (works in every project):

mkdir -p ~/.agents/skills
cp -r /path/to/ideatwister-engine/skills/ideatwister ~/.agents/skills/ideatwister

Project-level (scoped to one project):

mkdir -p .agents/skills
cp -r /path/to/ideatwister-engine/skills/ideatwister .agents/skills/ideatwister

Then restart OpenCode.

Verify the installation

In OpenCode, type:

use skill ideatwister

It should list the available commands.

First-run example

> /ideatwister "I want to build a B2B tool for accountants managing invoices"

Pick a Depth Mode:
  [1] Quick · [2] Standard · [3] Recommended (default) · [4] Deep · [5] Custom
> <Enter>

[Pipeline runs through the ten phases of the engine...]

✅ Pipeline Complete
Depth Mode: Recommended
Variations: 48
High conviction (8+): 5
Score range: 4.3 – 8.6
Time elapsed: 26 minutes

📊 Dashboard: ~/.ideatwister/runs/accountant-invoice-tool-2026-04-24/dashboard.html

Commands

Full details: commands.md.

Limitations

• Browser open: the dashboard path is printed - open it manually in your browser.
• Web search: handled by IdeaTwister's direct call to your chosen provider (Gemini, Anthropic, or OpenAI), not by OpenCode itself.
• Sequential execution: runs phases sequentially.

Troubleshooting

Skill not found

Verify the skill exists in one of the auto-discovered locations:

ls ~/.agents/skills/ideatwister

Re-run the installer or copy manually, then restart OpenCode.

Data store not found

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

Updating

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

Restart OpenCode. Your data in ~/.ideatwister/ is preserved.