中文 English

AI-powered development automation with multi-backend execution (Codex/Claude/Gemini)

This system leverages a dual-agent architecture with pluggable AI backends:

Why this separation?

• Claude Code excels at understanding context and orchestrating complex workflows
• Specialized backends (Codex for code, Claude for reasoning, Gemini for prototyping) excel at focused execution
• Backend selection via --backend codex|claude|gemini matches the model to the task

git clone https://github.com/cexll/myclaude.git
cd myclaude
python3 install.py --install-dir ~/.claude

The primary workflow for most development tasks.

/dev "implement user authentication with JWT"

6-Step Process:

1. Requirements Clarification - Interactive Q&A to clarify scope
2. Codex Deep Analysis - Codebase exploration and architecture decisions
3. Dev Plan Generation - Structured task breakdown with test requirements
4. Parallel Execution - Codex executes tasks concurrently
5. Coverage Validation - Enforce ≥90% test coverage
6. Completion Summary - Report with file changes and coverage stats

Key Features:

• Claude Code orchestrates, Codex executes all code changes
• Automatic task parallelization for speed
• Mandatory 90% test coverage gate
• Rollback on failure

Best For: Feature development, refactoring, bug fixes with tests

Full enterprise agile methodology with 6 specialized agents.

/bmad-pilot "build e-commerce checkout system"

Agents:

Process:

Requirements → Architecture → Sprint Plan → Development → Review → QA
     ↓              ↓             ↓            ↓          ↓       ↓
   PRD.md      DESIGN.md     SPRINT.md     Code      REVIEW.md  TEST.md

Best For: Large features, team coordination, enterprise projects

Lightweight requirements-to-code pipeline.

/requirements-pilot "implement API rate limiting"

Process:

1. Requirements generation with quality scoring
2. Implementation planning
3. Code generation
4. Review and testing

Best For: Quick prototypes, well-defined features

Direct commands for daily coding tasks.

Best For: Quick tasks, no workflow overhead needed

• Multi-backend execution: codeagent-wrapper --backend codex|claude|gemini (default codex) so you can match the model to the task without changing workflows.
• GitHub workflow commands: /gh-create-issue "short need" creates structured issues; /gh-issue-implement 123 pulls issue #123, drives development, and prepares the PR.
• Skills + hooks activation: .claude/hooks run automation (tests, reviews), while .claude/skills/skill-rules.json auto-suggests the right skills. Keep hooks enabled in .claude/settings.json to activate the enterprise workflow helpers.

Minimum version: Check compatibility with your installation

The codeagent-wrapper uses these Codex CLI features:

• codex e - Execute commands (shorthand for codex exec)
• --skip-git-repo-check - Skip git repository validation
• --json - JSON stream output format
• -C <workdir> - Set working directory
• resume <session_id> - Resume previous sessions

Verify Codex CLI is installed:

which codex
codex --version

Minimum version: Check compatibility with your installation

Required features:

• --output-format stream-json - Streaming JSON output format
• --setting-sources - Control setting sources (prevents infinite recursion)
• --dangerously-skip-permissions - Skip permission prompts (use with caution)
• -p - Prompt input flag
• -r <session_id> - Resume sessions

Security Note: The wrapper only adds --dangerously-skip-permissions for Claude when explicitly enabled (e.g. --skip-permissions / CODEAGENT_SKIP_PERMISSIONS=true). Keep it disabled unless you understand the risk.

Verify Claude CLI is installed:

which claude
claude --version

Minimum version: Check compatibility with your installation

Required features:

• -o stream-json - JSON stream output format
• -y - Auto-approve prompts (non-interactive mode)
• -r <session_id> - Resume sessions
• -p - Prompt input flag

Verify Gemini CLI is installed:

which gemini
gemini --version

# Install all enabled modules (dev + essentials by default)
python3 install.py --install-dir ~/.claude

# Install specific module
python3 install.py --module dev

# List available modules
python3 install.py --list-modules

# Force overwrite existing files
python3 install.py --force

~/.claude/
├── bin/
│   └── codeagent-wrapper    # Main executable
├── CLAUDE.md                # Core instructions and role definition
├── commands/                # Slash commands (/dev, /code, etc.)
├── agents/                  # Agent definitions
├── skills/
│   └── codex/
│       └── SKILL.md         # Codex integration skill
├── config.json              # Configuration
└── installed_modules.json   # Installation status

By default, myclaude installs to ~/.claude. You can customize this using the INSTALL_DIR environment variable:

# Install to custom directory
INSTALL_DIR=/opt/myclaude bash install.sh

# Update your PATH accordingly
export PATH="/opt/myclaude/bin:$PATH"

Directory Structure:

• $INSTALL_DIR/bin/ - codeagent-wrapper binary
• $INSTALL_DIR/skills/ - Skill definitions
• $INSTALL_DIR/config.json - Configuration file
• $INSTALL_DIR/commands/ - Slash command definitions
• $INSTALL_DIR/agents/ - Agent definitions

Note: When using a custom installation directory, ensure that $INSTALL_DIR/bin is added to your PATH environment variable.

Edit config.json to customize:

{
  "version": "1.0",
  "install_dir": "~/.claude",
  "modules": {
    "dev": {
      "enabled": true,
      "operations": [
        {"type": "merge_dir", "source": "dev-workflow"},
        {"type": "copy_file", "source": "memorys/CLAUDE.md", "target": "CLAUDE.md"},
        {"type": "copy_file", "source": "skills/codex/SKILL.md", "target": "skills/codex/SKILL.md"},
        {"type": "run_command", "command": "bash install.sh"}
      ]
    }
  }
}

Operation Types:

The codex skill enables Claude Code to delegate code execution to Codex CLI.

# Codex is invoked via the skill
codeagent-wrapper - <<'EOF'
implement @src/auth.ts with JWT validation
EOF

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: backend_api
workdir: /project/backend
---CONTENT---
implement REST endpoints for /api/users

---TASK---
id: frontend_ui
workdir: /project/frontend
dependencies: backend_api
---CONTENT---
create React components consuming the API
EOF

# Automatic (via dev module)
python3 install.py --module dev

# Manual
bash install.sh

Windows installs place codeagent-wrapper.exe in %USERPROFILE%\bin.

# PowerShell (recommended)
powershell -ExecutionPolicy Bypass -File install.ps1

# Batch (cmd)
install.bat

Add to PATH (if installer doesn't detect it):

# PowerShell - persistent for current user
[Environment]::SetEnvironmentVariable('PATH', "$HOME\bin;" + [Environment]::GetEnvironmentVariable('PATH','User'), 'User')

# PowerShell - current session only
$Env:PATH = "$HOME\bin;$Env:PATH"

REM cmd.exe - persistent for current user
setx PATH "%USERPROFILE%\bin;%PATH%"

Codex wrapper not found:

# Check PATH
echo $PATH | grep -q "$HOME/.claude/bin" || echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc

# Reinstall
bash install.sh

Permission denied:

python3 install.py --install-dir ~/.claude --force

Module not loading:

# Check installation status
cat ~/.claude/installed_modules.json

# Reinstall specific module
python3 install.py --module dev --force

Backend CLI not found:

# Check if backend CLIs are installed
which codex
which claude
which gemini

# Install missing backends
# Codex: Follow installation instructions at https://codex.docs
# Claude: Follow installation instructions at https://claude.ai/docs
# Gemini: Follow installation instructions at https://ai.google.dev/docs

Unsupported CLI flags:

# If you see errors like "unknown flag" or "invalid option"

# Check backend CLI version
codex --version
claude --version
gemini --version

# For Codex: Ensure it supports `e`, `--skip-git-repo-check`, `--json`, `-C`, and `resume`
# For Claude: Ensure it supports `--output-format stream-json`, `--setting-sources`, `-r`
# For Gemini: Ensure it supports `-o stream-json`, `-y`, `-r`, `-p`

# Update your backend CLI to the latest version if needed

JSON parsing errors:

# If you see "failed to parse JSON output" errors

# Verify the backend outputs stream-json format
codex e --json "test task"  # Should output newline-delimited JSON
claude --output-format stream-json -p "test"  # Should output stream JSON

# If not, your backend CLI version may be too old or incompatible

Infinite recursion with Claude backend:

# The wrapper prevents this with `--setting-sources ""` flag
# If you still see recursion, ensure your Claude CLI supports this flag

claude --help | grep "setting-sources"

# If flag is not supported, upgrade Claude CLI

Session resume failures:

# Check if session ID is valid
codex history  # List recent sessions
claude history

# Ensure backend CLI supports session resumption
codex resume <session_id> "test"  # Should continue from previous session
claude -r <session_id> "test"

# If not supported, use new sessions instead of resume mode

• Codeagent-Wrapper Guide - Multi-backend execution wrapper
• Hooks Documentation - Custom hooks and automation

• Installation Log - Installation history and troubleshooting

AGPL-3.0 License - see LICENSE

• Issues: GitHub Issues
• Documentation: docs/

Claude Code + Codex = Better Development - Orchestration meets execution.