Agent YOLO Dead Loop Handler

🚀 让 AI 开发更高效，更安全！

这个项目专门为各种 AI 开发工具提供 YOLO 模式配置方案，让你既能享受自动化带来的速度，又能保持开发效率。

🎯 项目目标

• ✅ 最大化自动化: 启用 YOLO 模式，减少手动确认
• ⚡ 提升开发效率: 自动化常规操作，专注核心开发
• 📚 统一配置方案: 为不同 AI 工具提供标准化配置

🛠️ 支持的工具

Claude Code

✅ 已完成配置和验证

OpenCode

✅ 已完成配置和验证（含一键脚本）

Codex

✅ 已完成 YOLO 模式和重复操作拦截配置

🚀 快速开始

📥 直接下载

如果你只想快速安装，可以直接下载脚本：

# 下载安装脚本
curl -o setup-yolo-mode.sh https://raw.githubusercontent.com/NeoMei/AgentYoloDeadLoopHandler/main/setup-yolo-mode.sh

# 添加执行权限
chmod +x setup-yolo-mode.sh

# 运行安装
./setup-yolo-mode.sh --global

一键安装脚本 ⚡

我们提供了便捷的安装脚本，让YOLO模式设置变得超简单：

# 克隆项目
git clone https://github.com/NeoMei/AgentYoloDeadLoopHandler.git
cd AgentYoloDeadLoopHandler

# 全局安装YOLO模式（推荐）
./setup-yolo-mode.sh --global

# 或者为当前项目安装
./setup-yolo-mode.sh --project

脚本功能：

• ✅ 自动备份现有配置
• ✅ 支持全局和项目安装
• ✅ 一键卸载功能
• ✅ 配置验证

手动安装

如果你想手动配置：

全局配置：

# 创建配置目录
mkdir -p ~/.claude

# 创建配置文件
cat > ~/.claude/settings.json << 'EOF'
{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Read",
      "Write",
      "Edit",
      "Bash",
      "LSP",
      "AskUserQuestion",
      "TaskCreate",
      "TaskUpdate",
      "Skill"
    ],
    "ask": []
  }
}
EOF

项目配置：

# 在项目根目录创建配置
mkdir -p .claude

cat > .claude/settings.json << 'EOF'
{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Read",
      "Write",
      "Edit",
      "Bash",
      "LSP",
      "AskUserQuestion",
      "TaskCreate",
      "TaskUpdate",
      "Skill"
    ],
    "ask": []
  }
}
EOF

📖 使用指南

Claude Code 配置

1. YOLO 模式配置

在项目目录下创建 .claude/settings.json:

{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Read",
      "Write",
      "Edit",
      "Bash",
      "LSP",
      "AskUserQuestion",
      "TaskCreate",
      "TaskUpdate",
      "Skill"
    ],
    "ask": []
  }
}

2. 全局配置

如要在所有项目中启用 YOLO 模式，修改全局配置：

# 编辑全局配置
nano ~/.claude/settings.json

添加相同的配置内容。

3. 工作原理

YOLO 模式体验:

• ✅ 所有操作立即执行
• ✅ 无需手动确认
• ✅ 完全自动化体验
• ✅ 最大化开发效率

典型操作自动化:

• 文件读写：Read, Write, Edit
• 命令执行：Bash
• 代码操作：LSP
• 任务管理：TaskCreate, TaskUpdate
• 技能调用：Skill

4. 完整配置文件

参见 configurations/claude-code/ 目录下的完整配置文件。

OpenCode 配置

1. 一键启用（推荐）

# 启用 YOLO 模式（全局配置）
./configurations/opencode/setup-yolo.sh

# 仅在当前项目启用
./configurations/opencode/setup-yolo.sh -p

# 查看状态 / 还原
./configurations/opencode/setup-yolo.sh --status
./configurations/opencode/setup-yolo.sh --revert

脚本会自动备份原配置并合并 YOLO 权限，不触碰任何密钥。

2. 核心配置

在全局配置 ~/.config/opencode/opencode.json 或项目级 opencode.json 中添加：

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "*": "allow",
    "doom_loop": "ask",
    "bash": {
      "rm -rf /": "deny"
    }
  }
}

• "*": "allow" — 全部操作自动放行（YOLO 核心）
• doom_loop: "ask" — 死循环兜底拦截
• bash.* : "deny" — 封禁不可逆破坏性命令

3. 完整配置文件

参见 configurations/opencode/ 目录下的 yolo-mode.json 与 setup-yolo.sh。

Codex 配置

Codex 配置位于 configurations/codex/，包含 YOLO 模式和重复操作拦截。

1. 一键安装

git clone https://github.com/NeoMei/AgentYoloDeadLoopHandler.git
cd AgentYoloDeadLoopHandler
configurations/codex/install_yolo.sh

安装完成后重启 Codex。

2. 安装内容

• 启用 approval_policy = "never"
• 启用 sandbox_mode = "danger-full-access"
• 安装 ~/.codex/hooks/repeat_guard.rb
• 注册 PreToolUse 重复操作拦截 hook
• 同一操作 60 秒内允许 3 次，第 4 次返回 decision = "block"
• 重复运行安装脚本不会重复追加配置

3. 验证安装脚本

configurations/codex/test_install_yolo.sh

该测试会使用临时 HOME，验证一键安装、重复安装幂等性，以及 hook 不会被重复写入。

4. 安全提醒

YOLO 模式会跳过人工审批并使用 danger-full-access。建议只在可信本地开发、容器、临时 worktree 或其他外部隔离环境中使用。不要提交真实的 ~/.codex/auth.json、日志、状态库或包含私有路径的 ~/.codex/config.toml。

详细说明见 configurations/codex/README.md。

🔧 安装和使用

Claude Code

1. 复制配置文件到你的项目：

cp configurations/claude-code/complete-config.json /path/to/your/project/.claude/settings.json

2. 复制配置到全局设置（可选）：

cp configurations/claude-code/complete-config.json ~/.claude/settings.json

3. 重启 Claude Code 或重新加载配置

4. 开始享受 YOLO 模式！

🎨 配置选项说明

权限模式

模式	说明	推荐场景
auto	自动批准所有操作	开发环境
normal	需要确认操作	生产环境
bypassPermissions	完全绕过权限	高级用户

自动批准的操作

操作	说明	用途
Read	文件读取	查看代码和文档
Write	文件写入	创建新文件
Edit	文件编辑	修改现有文件
Bash	命令执行	运行脚本和工具
LSP	代码智能	跳转定义和查找引用
TaskCreate/Update	任务管理	跟踪工作进度
Skill	技能调用	使用特定功能

🔍 示例场景

正常使用 ✅

# 这些操作都会立即执行
echo "test" > file.txt
cat file.txt
npm install
git status

自动化工作流 ✅

# 复杂操作序列也无缝执行
npm install
npm run build
git add .
git commit -m "Update project"
git push

开发环境典型场景 ✅

# 前端开发完整流程
npm install              # 安装依赖
npm run dev             # 启动开发服务器
# 编辑组件文件
# 重启服务器查看效果
npm run build          # 构建生产版本
npm test              # 运行测试

📋 版本信息

当前版本：v1.0.0 🎉

查看详细发布说明：v1.0.0 Release Notes

更新日志：CHANGELOG.md

📂 项目结构

AgentYoloDeadLoopHandler/
├── setup-yolo-mode.sh        # 一键安装脚本
├── README.md
├── LICENSE
├── CONTRIBUTING.md
├── configurations/
│   ├── claude-code/
│   │   ├── README.md
│   │   ├── yolo-mode.json
│   │   └── complete-config.json
│   ├── opencode/
│   │   ├── README.md
│   │   ├── yolo-mode.json
│   │   └── setup-yolo.sh
│   └── codex/
│       ├── README.md
│       ├── repeat_guard.rb
│       ├── install_yolo.sh
│       ├── install_repeat_guard.rb
│       ├── codex-config-snippet.toml
│       └── test_install_yolo.sh
└── examples/
    ├── basic-usage.md
    └── advanced-scenarios.md

🛡️ 安全建议

1. 仅在可信环境中使用 YOLO 模式
2. 定期检查配置文件
3. 使用版本控制保护重要文件
4. 敏感项目建议保持默认确认模式

🔧 高级配置

环境特定配置

开发环境 (完全自动):

{
  "permissions": {
    "defaultMode": "auto",
    "allow": ["Read", "Write", "Edit", "Bash", "LSP"],
    "ask": []
  }
}

生产环境 (保守模式):

{
  "permissions": {
    "defaultMode": "normal",
    "allow": ["Read", "Write", "Edit"],
    "ask": ["Bash"]
  }
}

团队协作配置

统一团队配置:

# 将配置文件提交到项目仓库
git add .claude/settings.json
git commit -m "Add team YOLO mode config"
git push

# 团队成员拉取后自动应用
git pull

🤝 贡献指南

我们欢迎各种贡献！

待补充的内容

• OpenCode 配置文档
• Codex 配置文档
• 更多 AI 工具配置
• 高级使用示例
• 性能优化建议

如何贡献

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

详细的贡献指南请查看 CONTRIBUTING.md

📝 License

本项目采用 MIT 许可证 - 详见 LICENSE 文件

🌟 Star History

如果这个项目对你有帮助，请给一个 ⭐️！

💬 讨论

• 有问题？在 Issues 中提出
• 想讨论？在 Discussions 中交流

---

让 AI 开发更快、更安全！ 🚀🛡️