mirror of
https://github.com/cexll/myclaude.git
synced 2026-02-11 03:23:50 +08:00
ebd795c583
- Add per-module agent merge/unmerge for ~/.codeagent/models.json with __module__ tracking, user-customization protection, and agent restore on uninstall when shared by multiple modules - Add post-install verification (wrapper version, PATH, backend CLIs) - Install CLAUDE.md by default, best-effort (never crashes main flow) - Fix 7-phase → 5-phase references across all docs - Document 9 skills, 11 commands, claudekit module, OpenCode backend - Add templates/models.json.example with all agent presets (do + omo) - Fix empty parent directory cleanup on copy_file uninstall - Update USER_GUIDE.md with 13 CLI flags and OpenCode backend Generated with SWE-Agent.ai Co-Authored-By: SWE-Agent.ai <noreply@swe-agent.ai>
5.8 KiB
5.8 KiB
Claude Code Multi-Agent Workflow System
AI-powered development automation with multi-backend execution (Codex/Claude/Gemini/OpenCode)
Quick Start
npx github:cexll/myclaude
Modules Overview
| Module | Description | Documentation |
|---|---|---|
| do | Recommended - 5-phase feature development with codeagent orchestration | /do command |
| omo | Multi-agent orchestration with intelligent routing | /omo command |
| bmad | BMAD agile workflow with 6 specialized agents | /bmad-pilot command |
| requirements | Lightweight requirements-to-code pipeline | /requirements-pilot command |
| essentials | 11 core dev commands: ask, bugfix, code, debug, docs, enhance-prompt, optimize, refactor, review, test, think | /code, /debug, etc. |
| sparv | SPARV workflow (Specify→Plan→Act→Review→Vault) | /sparv command |
| course | Course development (combines dev + product-requirements + test-cases) | Composite module |
| claudekit | ClaudeKit: do skill + global hooks (pre-bash, inject-spec, log-prompt) | Composite module |
Available Skills
Individual skills can be installed separately via npx github:cexll/myclaude --list (skills bundled in modules like do, omo, sparv are listed above):
| Skill | Description |
|---|---|
| browser | Browser automation for web testing and data extraction |
| codeagent | codeagent-wrapper invocation for multi-backend AI code tasks |
| codex | Direct Codex backend execution |
| dev | Lightweight end-to-end development workflow |
| gemini | Direct Gemini backend execution |
| product-requirements | Interactive PRD generation with quality scoring |
| prototype-prompt-generator | Structured UI/UX prototype prompt generation |
| skill-install | Install skills from GitHub with security scanning |
| test-cases | Comprehensive test case generation from requirements |
Installation
# Interactive installer (recommended)
npx github:cexll/myclaude
# List installable items (modules / skills / wrapper)
npx github:cexll/myclaude --list
# Detect installed modules and update from GitHub
npx github:cexll/myclaude --update
# Custom install directory / overwrite
npx github:cexll/myclaude --install-dir ~/.claude --force
--update detects already installed modules in the target install dir (defaults to ~/.claude, via installed_modules.json when present) and updates them from GitHub (latest release) by overwriting the module files.
Module Configuration
Edit config.json to enable/disable modules:
{
"modules": {
"bmad": { "enabled": false },
"requirements": { "enabled": false },
"essentials": { "enabled": false },
"omo": { "enabled": false },
"sparv": { "enabled": false },
"do": { "enabled": true },
"course": { "enabled": false }
}
}
Workflow Selection Guide
| Scenario | Recommended |
|---|---|
| Feature development (default) | /do |
| Bug investigation + fix | /omo |
| Large enterprise project | /bmad-pilot |
| Quick prototype | /requirements-pilot |
| Simple task | /code, /debug |
Core Architecture
| Role | Agent | Responsibility |
|---|---|---|
| Orchestrator | Claude Code | Planning, context gathering, verification |
| Executor | codeagent-wrapper | Code editing, test execution (Codex/Claude/Gemini/OpenCode) |
Backend CLI Requirements
| Backend | Required Features |
|---|---|
| Codex | codex e, --json, -C, resume |
| Claude | --output-format stream-json, -r |
| Gemini | -o stream-json, -y, -r |
| OpenCode | opencode, stdin mode |
Directory Structure After Installation
~/.claude/
├── bin/codeagent-wrapper
├── CLAUDE.md (installed by default)
├── commands/ (from essentials module)
├── agents/ (from bmad/requirements modules)
├── skills/ (from do/omo/sparv/course modules)
├── hooks/ (from claudekit module)
├── settings.json (auto-generated, hooks config)
└── installed_modules.json (auto-generated, tracks modules)
Documentation
Troubleshooting
Common Issues
Codex wrapper not found:
# Select: codeagent-wrapper
npx github:cexll/myclaude
Module not loading:
cat ~/.claude/installed_modules.json
npx github:cexll/myclaude --force
Backend CLI errors:
which codex && codex --version
which claude && claude --version
which gemini && gemini --version
FAQ
| Issue | Solution |
|---|---|
| "Unknown event format" | Logging display issue, can be ignored |
| Gemini can't read .gitignore files | Remove from .gitignore or use different backend |
| Codex permission denied | Set approval_policy = "never" in ~/.codex/config.yaml |
See GitHub Issues for more.
License
AGPL-3.0 - see LICENSE
Commercial Licensing
For commercial use without AGPL obligations, contact: evanxian9@gmail.com