后端选择指南

Codex（默认）：

• 深度代码理解和复杂逻辑实现
• 具有精确依赖跟踪的大规模重构
• 算法优化和性能调优
• 示例："分析 @src/core 的调用图并重构模块依赖结构"

Claude：

• 需求明确时的快速功能实现
• 技术文档、API 规范、README 生成
• 专业的提示工程（例如，产品需求、设计规范）
• 示例："为 @package.json 生成包含安装、使用和 API 文档的全面 README"

Gemini：

• UI 组件脚手架和布局原型设计
• 保持样式一致性的设计系统实现
• 支持无障碍访问的交互元素生成
• 示例："创建一个带有侧边栏导航和数据可视化卡片的响应式仪表板布局"

后端切换：

• 使用 Codex 进行分析，切换到 Claude 编写文档，然后使用 Gemini 实现 UI
• 在并行模式下为每个任务选择最适合的后端以优化性能

参数

• task（必需）：任务描述，支持 @file 引用
• working_dir（可选）：工作目录（默认：当前目录）
• --backend（可选）：选择 AI 后端（codex/claude/gemini，默认：codex）
  • 注意：Claude 后端仅在显式启用时才会添加 --dangerously-skip-permissions

返回格式

智能体响应文本...

---
SESSION_ID: 019a7247-ac9d-71f3-89e2-a823dbd8fd14

恢复会话

# 使用默认后端恢复
codeagent-wrapper resume <session_id> - <<'EOF'
<后续任务>
EOF

# 使用特定后端恢复
codeagent-wrapper --backend claude resume <session_id> - <<'EOF'
<后续任务>
EOF

并行执行

默认（摘要模式 - 节省上下文）：

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: task1
backend: codex
workdir: /path/to/dir
---CONTENT---
任务内容
---TASK---
id: task2
dependencies: task1
---CONTENT---
依赖任务
EOF

完整输出模式（用于调试）：

codeagent-wrapper --parallel --full-output <<'EOF'
...
EOF

输出模式：

• 摘要（默认）：包含变更、输出、验证和评审摘要的结构化报告。
• 完整（--full-output）：完整的任务消息。仅在调试特定失败时使用。

为每个任务指定后端：

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: task1
backend: codex
workdir: /path/to/dir
---CONTENT---
分析代码结构
---TASK---
id: task2
backend: claude
dependencies: task1
---CONTENT---
基于分析设计架构
---TASK---
id: task3
backend: gemini
dependencies: task2
---CONTENT---
生成实现代码
EOF

并发控制：设置 CODEAGENT_MAX_PARALLEL_WORKERS 以限制并发任务数（默认：无限制）。

环境变量

• CODEX_TIMEOUT：覆盖超时时间（毫秒）（默认：7200000 = 2 小时）
• CODEAGENT_SKIP_PERMISSIONS：控制 Claude CLI 权限检查
  • 对于 Claude 后端：设置为 true/1 以添加 --dangerously-skip-permissions（默认：禁用）
  • 对于 Codex/Gemini 后端：目前无效果
• CODEAGENT_MAX_PARALLEL_WORKERS：限制并行模式下的并发任务数（默认：无限制，推荐：8）

调用模式

单个任务：

Bash 工具参数：
- command: codeagent-wrapper --backend <backend> - [working_dir] <<'EOF'
  <任务内容>
  EOF
- timeout: 7200000
- description: <简要描述>

并行任务：

Bash 工具参数：
- command: codeagent-wrapper --parallel --backend <backend> <<'EOF'
  ---TASK---
  id: task_id
  backend: <backend>  # 可选，覆盖全局设置
  workdir: /path
  dependencies: dep1, dep2
  ---CONTENT---
  任务内容
  EOF
- timeout: 7200000
- description: <简要描述>

安全最佳实践

• Claude 后端：默认启用权限检查
  • 要跳过检查：设置 CODEAGENT_SKIP_PERMISSIONS=true 或传递 --skip-permissions
• 并发限制：在生产环境中设置 CODEAGENT_MAX_PARALLEL_WORKERS 以防止资源耗尽
• 自动化上下文：此包装器专为 AI 驱动的自动化设计，其中权限提示会阻塞执行

最近更新

• 所有模式（workdir、resume、parallel）均支持多后端
• 具有可配置权限检查的安全控制
• 具有工作池和快速失败取消机制的并发限制

每周安装数

1

仓库

cacr92/wereply

首次出现

今天

安全审计

Gen Agent Trust HubWarnSocketPassSnykWarn

安装于

zencoder1

amp1

cline1

openclaw1

opencode1

cursor1

Backend Selection Guide

Codex (default):

• Deep code understanding and complex logic implementation
• Large-scale refactoring with precise dependency tracking
• Algorithm optimization and performance tuning
• Example: "Analyze the call graph of @src/core and refactor the module dependency structure"

Claude :

• Quick feature implementation with clear requirements
• Technical documentation, API specs, README generation
• Professional prompt engineering (e.g., product requirements, design specs)
• Example: "Generate a comprehensive README for @package.json with installation, usage, and API docs"

Gemini :

• UI component scaffolding and layout prototyping
• Design system implementation with style consistency
• Interactive element generation with accessibility support
• Example: "Create a responsive dashboard layout with sidebar navigation and data visualization cards"

Backend Switching :

• Start with Codex for analysis, switch to Claude for documentation, then Gemini for UI implementation
• Use per-task backend selection in parallel mode to optimize for each task's strengths

Parameters

• task (required): Task description, supports @file references
• working_dir (optional): Working directory (default: current)
• --backend (optional): Select AI backend (codex/claude/gemini, default: codex)
  • Note : Claude backend only adds --dangerously-skip-permissions when explicitly enabled

Return Format

Agent response text here...

---
SESSION_ID: 019a7247-ac9d-71f3-89e2-a823dbd8fd14

Resume Session

# Resume with default backend
codeagent-wrapper resume <session_id> - <<'EOF'
<follow-up task>
EOF

# Resume with specific backend
codeagent-wrapper --backend claude resume <session_id> - <<'EOF'
<follow-up task>
EOF

Parallel Execution

Default (summary mode - context-efficient):

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: task1
backend: codex
workdir: /path/to/dir
---CONTENT---
task content
---TASK---
id: task2
dependencies: task1
---CONTENT---
dependent task
EOF

Full output mode (for debugging):

codeagent-wrapper --parallel --full-output <<'EOF'
...
EOF

Output Modes:

• Summary (default) : Structured report with changes, output, verification, and review summary.
• Full (--full-output): Complete task messages. Use only when debugging specific failures.

With per-task backend :

codeagent-wrapper --parallel <<'EOF'
---TASK---
id: task1
backend: codex
workdir: /path/to/dir
---CONTENT---
analyze code structure
---TASK---
id: task2
backend: claude
dependencies: task1
---CONTENT---
design architecture based on analysis
---TASK---
id: task3
backend: gemini
dependencies: task2
---CONTENT---
generate implementation code
EOF

Concurrency Control : Set CODEAGENT_MAX_PARALLEL_WORKERS to limit concurrent tasks (default: unlimited).

Environment Variables

• CODEX_TIMEOUT: Override timeout in milliseconds (default: 7200000 = 2 hours)
• CODEAGENT_SKIP_PERMISSIONS: Control Claude CLI permission checks
  • For Claude backend: Set to true/1 to add --dangerously-skip-permissions (default: disabled)
  • For Codex/Gemini backends: Currently has no effect
• CODEAGENT_MAX_PARALLEL_WORKERS: Limit concurrent tasks in parallel mode (default: unlimited, recommended: 8)

Invocation Pattern

Single Task :

Bash tool parameters:
- command: codeagent-wrapper --backend <backend> - [working_dir] <<'EOF'
  <task content>
  EOF
- timeout: 7200000
- description: <brief description>

Parallel Tasks :

Bash tool parameters:
- command: codeagent-wrapper --parallel --backend <backend> <<'EOF'
  ---TASK---
  id: task_id
  backend: <backend>  # Optional, overrides global
  workdir: /path
  dependencies: dep1, dep2
  ---CONTENT---
  task content
  EOF
- timeout: 7200000
- description: <brief description>

Security Best Practices

• Claude Backend : Permission checks enabled by default
  • To skip checks: set CODEAGENT_SKIP_PERMISSIONS=true or pass --skip-permissions
• Concurrency Limits : Set CODEAGENT_MAX_PARALLEL_WORKERS in production to prevent resource exhaustion
• Automation Context : This wrapper is designed for AI-driven automation where permission prompts would block execution

Recent Updates

• Multi-backend support for all modes (workdir, resume, parallel)
• Security controls with configurable permission checks
• Concurrency limits with worker pool and fail-fast cancellation

Weekly Installs

1

Repository

cacr92/wereply

First Seen

Today

Security Audits

Gen Agent Trust HubWarnSocketPassSnykWarn

Installed on

zencoder1

amp1

cline1

openclaw1

opencode1

cursor1