Idea Coach

AI-powered idea/problem/challenge manager with GitHub integration. Captures, categorizes, reviews, and helps ship ideas to repos.

Pasang
$clawhub install idea-coach

Idea Coach

Your critical sparring partner for ideas, problems, and challenges — now with GitHub integration!

What It Does

Idea Coach helps you:

  • Capture ideas, problems, and challenges as they come

  • Categorize by type, domain, energy, urgency, and importance

  • Review periodically (daily → quarterly based on importance)

  • Ship ideas to GitHub repos when ready

  • Track progress and know when to let go

Philosophy

Be critical, not just supportive. Idea Coach will:

  • Suggest dropping ideas that aren't worth pursuing

  • Ask hard questions during reviews

  • Track which ideas actually ship vs. rot forever

Commands

Core Commands

Command Description
/idea <text> Capture a new idea
/idea_list List active ideas
/idea_list --due Show ideas due for review
/idea_get <id> Get idea details
/idea_update <id> Update idea attributes
/idea_review <id> Add review interaction
/idea_drop <id> Mark as dropped (requires reason)
/idea_done <id> Mark as completed
/idea_stats Show statistics

GitHub Commands

Command Description
/idea_link <id> <owner/repo> Link to existing repo
/idea_ship <id> Create new repo for idea
/idea_ship <id> --public Create public repo
/idea_repo <id> Show linked repo status
/idea_sync <id> Create/update GitHub issue

Attributes

Types

  • 💡 idea — Something to build or create

  • 🔧 problem — Something to fix or solve

  • 🎯 challenge — Something to overcome

Status Flow

captured → exploring → developing → shipped/done
                ↓           ↓
             parked      blocked
                ↓
             dropped

Importance → Review Cycle

Importance Energy Review Cycle
critical high daily
critical * weekly
important high weekly
important * biweekly
nice-to-have * monthly
parked * quarterly

GitHub Integration

Prerequisites

  • gh CLI installed and authenticated

  • Run gh auth login if not set up

Workflow Example


# 1. Capture idea
/idea "Build a CLI for task management"

# 2. Develop it
/idea_update abc123 --status developing

# 3. Ship it to GitHub
/idea_ship abc123

# 4. Or link to existing repo
/idea_link abc123 moinsen-dev/my-cli

# 5. Check repo status
/idea_repo abc123

# 6. Sync as GitHub issue
/idea_sync abc123

CLI Usage


# Add idea
python scripts/coach.py add "Build something cool" --type idea --importance important

# List ideas
python scripts/coach.py list
python scripts/coach.py list --due
python scripts/coach.py list --github  # Only with linked repos

# GitHub operations
python scripts/coach.py link <id> owner/repo
python scripts/coach.py ship <id> --owner moinsen-dev
python scripts/coach.py repo-status <id>
python scripts/coach.py sync-issue <id> --labels enhancement,idea

Data Storage

Ideas are stored in ~/.openclaw/idea-coach/ideas.json

Each idea tracks:

  • Basic info (title, description, type, domain)

  • Status and progress

  • Energy, urgency, importance

  • Review schedule and history

  • GitHub integration (repo, issue, sync timestamps)

  • Interaction log

Tips

  1. Capture quickly — Don't overthink the initial capture

  2. Review honestly — Use reviews to kill stale ideas

  3. Ship early — Create a repo as soon as an idea has momentum

  4. Sync issues — Use GitHub issues for detailed tracking

  5. Drop freely — A dropped idea is a decision, not a failure