{"id":29806301,"url":"https://github.com/gtrusler/claude-code-heavy","last_synced_at":"2025-07-28T14:08:04.333Z","repository":{"id":305196443,"uuid":"1022216270","full_name":"gtrusler/claude-code-heavy","owner":"gtrusler","description":"Multi-agent research orchestration using Claude Code. Inspired by make-it-heavy.","archived":false,"fork":false,"pushed_at":"2025-07-18T20:10:31.000Z","size":152,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T21:48:43.589Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gtrusler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-18T16:47:14.000Z","updated_at":"2025-07-18T21:22:21.000Z","dependencies_parsed_at":"2025-07-18T21:58:56.211Z","dependency_job_id":null,"html_url":"https://github.com/gtrusler/claude-code-heavy","commit_stats":null,"previous_names":["gtrusler/claude-code-heavy"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gtrusler/claude-code-heavy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtrusler%2Fclaude-code-heavy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtrusler%2Fclaude-code-heavy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtrusler%2Fclaude-code-heavy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtrusler%2Fclaude-code-heavy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gtrusler","download_url":"https://codeload.github.com/gtrusler/claude-code-heavy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtrusler%2Fclaude-code-heavy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267527835,"owners_count":24102019,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-28T14:05:56.636Z","updated_at":"2025-07-28T14:08:04.322Z","avatar_url":"https://github.com/gtrusler.png","language":"Shell","readme":"# Claude Code Heavy\n\nA powerful multi-agent research system using Claude Code to deliver comprehensive, multi-perspective analysis through intelligent orchestration. Inspired by Grok's heavy mode and make-it-heavy.\n\n## 🚀 What is Claude Code Heavy?\n\nClaude Code Heavy gives Claude full control to orchestrate parallel research:\n- 🧠 **Intelligent Planning**: Claude analyzes your query and creates the optimal research strategy\n- 🔀 **Parallel Research**: Claude decides how many agents to deploy (2-8 available)\n- 🎯 **Dynamic Adaptation**: Questions and roles are tailored to your specific query\n- 🔄 **Smart Synthesis**: Claude combines all findings into unified insights\n- 🚙 **Interactive Mode**: Simple setup with powerful results\n\n## 🎯 Quick Start\n\n```bash\n# Clone the repo\ngit clone https://github.com/yourusername/claude-code-heavy\ncd claude-code-heavy\n\n# Make script executable\nchmod +x ccheavy.sh\n\n# Run interactively (recommended)\n./ccheavy.sh\n\n# Or run with command line args\n./ccheavy.sh \"How do we solve the global water supply issue?\"\n```\n\n## 🤔 Why This Approach?\n\n**Claude is the Intelligence**: Instead of hard-coding research patterns, we let Claude:\n- Analyze your query and determine the best approach\n- Decide how many research assistants are needed\n- Create specific, targeted research questions\n- Adapt the research strategy in real-time\n\n**Pre-built Infrastructure**: The script simply:\n- Creates 8 research workspaces (worktrees)\n- Sets up output directories\n- Launches Claude with full orchestration control\n\n## 📖 How It Works\n\n```mermaid\ngraph TD\n    A[Run ./ccheavy.sh] --\u003e B[Setup Workspaces]\n    B --\u003e C[Claude Analyzes Query]\n    C --\u003e D[Creates Research Plan]\n    D --\u003e E[Decides Assistant Count]\n    E --\u003e F[Generates Questions]\n    F --\u003e G[Parallel Research Phase]\n    G --\u003e H1[RA-1 Research]\n    G --\u003e H2[RA-2 Research]\n    G --\u003e H3[RA-3 Research]\n    G --\u003e H4[... RA-N Research]\n    H1 --\u003e I[Synthesis]\n    H2 --\u003e I\n    H3 --\u003e I\n    H4 --\u003e I\n    I --\u003e J[Final Analysis]\n```\n\n### Process Flow\n\n1. **You provide a query**: Any research question or topic\n2. **Script prepares environment**: Creates 8 workspaces, output directories\n3. **Claude takes over**:\n   - Analyzes complexity and scope\n   - Plans optimal research strategy\n   - Creates targeted questions\n   - Orchestrates parallel execution\n   - Synthesizes comprehensive results\n\n## 🛠️ Installation\n\n### Prerequisites\n- Claude Code installed (`npm install -g @anthropic-ai/claude-code`)\n- Claude Pro or Teams subscription (strongly recommended for best performance)\n- Git with worktree support (git 2.7+)\n- Unix-like environment (Mac/Linux/WSL)\n\n### Setup\n```bash\n# Clone and setup\ngit clone https://github.com/gtrusler/claude-code-heavy\ncd claude-code-heavy\n./setup.sh\n```\n\n## 🎮 Usage\n\n### Interactive Mode (Recommended)\n```bash\n./ccheavy.sh\n# Follow the prompts:\n# - Enter your research question\n# - Choose output format (markdown/text)\n# - Decide on dangerous mode (default: N)\n# - Confirm to proceed (default: Y)\n# - Optionally auto-launch Claude Code (default: Y)\n```\n\n### Command Line Mode\n```bash\n# Basic usage\n./ccheavy.sh \"What are the latest advances in quantum computing?\"\n\n# With text output\n./ccheavy.sh \"Explain Docker containers\" text\n\n# YOLO mode\n./ccheavy.sh \"Analyze my codebase\" markdown --dangerous\n```\n\n### Output Structure\n```\noutputs/\n└── 2025-07-18-solve-global-water-crisis/\n    ├── orchestration-prompt.md    # Initial prompt for Claude\n    ├── research-plan.md          # Claude's research strategy\n    ├── assistants/\n    │   ├── ra-1-findings.md      # Assistant 1's research\n    │   ├── ra-2-findings.md      # Assistant 2's research\n    │   └── ...                   # Up to 8 assistants\n    └── final-analysis.md         # Synthesized results\n```\n\n## 📋 Example Outputs\n\nSee the `examples/` directory for complete research outputs:\n\n### 1. Austin's 5-Year Outlook\n- **Query**: \"What does the outlook for the next 5 years look like for Austin, TX?\"\n- **Assistants**: 6 (Claude's decision based on complexity)\n- **Total Output**: ~11,500 words\n- **Key Insights**: Economic growth, tech hub evolution, infrastructure challenges\n\n### 2. AI's Impact on Healthcare  \n- **Query**: \"How will AI impact healthcare?\"\n- **Assistants**: 5 (covering different healthcare domains)\n- **Focus Areas**: Diagnostics, drug discovery, patient care, ethics, implementation\n- **Comprehensive analysis** of transformation across the industry\n\nQuick examples of queries Claude handles well:\n\n- **Scientific**: \"How do mRNA vaccines work?\"\n- **Business**: \"Analyze the electric vehicle market\"\n- **Policy**: \"Evaluate universal basic income proposals\"\n- **Technical**: \"Compare Rust vs Go for systems programming\"\n- **Historical**: \"What led to the fall of the Roman Empire?\"\n- **Local**: \"What's the 5-year outlook for Austin, TX?\"\n\n## 🔧 Configuration\n\nThe script is intentionally minimal. Claude handles:\n- Determining optimal assistant count\n- Creating research questions\n- Assigning roles and perspectives\n- Adapting to query complexity\n\n## 🚀 Advanced Features\n\n### Security Options\n- Option to use `--dangerously-skip-permissions` flag\n- Default is secure mode (recommended)\n- Only enable for trusted research tasks\n\n### Parallel Execution\n- Claude orchestrates parallel tool calls\n- Multiple web searches execute simultaneously\n- Faster research completion\n\n### Smart Folder Naming\n- Queries converted to readable folder names automatically\n- Date prefixing for easy chronological sorting\n- Example: \"How will AI impact health care?\" → `2025-07-18-how-will-ai-impact-health-care`\n\n## 🏗️ Architecture\n\n### Why Git Worktrees?\n- Each assistant gets isolated workspace\n- Parallel execution without conflicts\n- Easy context switching for Claude\n- Git tracks all research history\n\n### Why Let Claude Decide?\n- Every query is unique\n- Claude understands context better\n- Dynamic adaptation beats static patterns\n- Optimal resource allocation\n\n## 🐛 Troubleshooting\n\n### \"Command not found: claude\"\nMake sure Claude Code is installed: `npm install -g @anthropic-ai/claude-code`\n\n### \"Git worktree error\"\n```bash\n# Update git\nbrew upgrade git  # Mac\nsudo apt-get update \u0026\u0026 sudo apt-get upgrade git  # Linux\n```\n\n### Research seems slow\n- Normal research takes 5-10 minutes\n- Complex queries may take up to 15-20 minutes\n- Check if web searches are working\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch\n3. Test with various query types\n4. Submit a pull request\n\n## 📄 License\n\nMIT License with Commercial Attribution Requirement\n\n**For products with 100K+ users**: Please include attribution to Graydon Trusler and mention the \"Claude Code Heavy\" framework in your documentation or credits.\n\nSee [LICENSE](LICENSE) file for full details.\n\n## 🙏 Acknowledgments\n\n- Inspired by [make-it-heavy](https://github.com/Doriandarko/make-it-heavy) by Pietro Schirano\n- Inspired by Grok Heavy mode\n- Built on Claude Code by Anthropic\n","funding_links":[],"categories":["Agents \u0026 Agent Managers"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgtrusler%2Fclaude-code-heavy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgtrusler%2Fclaude-code-heavy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgtrusler%2Fclaude-code-heavy/lists"}