mcpField
R
reset-agent-env

reset-agent-env

github.com/c0nantAgent 工作流336 次安装2 周前更新
代码仓库

关于 reset-agent-env

reset-agent-env 是用于盘点并清除多种 Agent 环境全局配置的 Claude 技能。默认先执行不改动文件的预览;确认后可备份移除,或直接删除。

主要功能

  1. 01按 Agent 分类预览待处理内容
  2. 02通过重复参数选择 Agent
  3. 03可备份移除或直接删除
  4. 04对 JSON 配置进行定点修改

适用场景

  1. 01清理前预览全局 Agent 配置
  2. 02为测试准备干净环境
  3. 03交接前清除选定 Agent 配置

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/c0nant/skills --skill reset-agent-env

安装后在 Claude Code 中输入/reset-agent-env确认已加载。

附带文件scripts/reset-agent-env.sh

详细介绍

重置 Agent 环境

清除此计算机上的 全局 Agent 配置:所有 Agent 框架中的技能、钩子、规则和 MCP 服务,以便测试从零开始的安装,或移交干净的环境。

此操作具有破坏性。脚本默认执行 试运行;在确认模式之前,不会删除任何内容。

流程

1. 清点(试运行)

不带任何标志运行捆绑脚本。脚本会按 Agent 分组,准确列出已有内容及将要删除的内容,且不会做任何更改:

bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh

向用户展示输出。

2. 确认范围和模式

向用户询问以下两项:

  • 哪些 Agent? 全部(默认),或通过可重复使用的 --agent 指定部分 Agent: claude · agents(~/.agents/skills 标准目录)· cursor · windsurf · antigravity。
  • 备份还是彻底删除?
    • --apply(推荐):将所有内容移至 ~/.cache/agent-env-reset/<timestamp>/,以便恢复。
    • --hard:直接删除,不备份。
3. 执行

使用所选标志和 --yes 运行(用户已确认):

# everything, reversible:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh --apply --yes

# scoped + hard delete:
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh --hard --agent claude --agent cursor --yes
4. 报告

告知用户删除了哪些内容。对于 --apply,提供备份路径和恢复提示(将文件移出备份目录)。

此技能位于 ~/.claude/skills 下,因此完整重置 Claude Code 会删除该技能本身:再次使用前,请通过 npx skills@latest add C0nanT/skills 重新安装。

操作范围

Agent目标
Claude Code~/.claude/skills、~/.claude/hooks-lib、~/.claude/hooks、~/.claude/commands、~/.claude/CLAUDE.md;仅从 settings.json / settings.local.json 中移除 .hooks,并从 ~/.claude.json 中移除 .mcpServers
Agent-Skills standard~/.agents/skills
Cursor~/.cursor/rules、~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/memories/global_rules.md、~/.codeium/windsurf/mcp_config.json
Antigravity~/.antigravity、~/.config/antigravity(尽力处理)

注意事项

  • Claude Code 和 ~/.agents/skills 目录的覆盖完整;对 Cursor / Windsurf / Antigravity 则尽力处理:只会操作已存在的路径。

  • JSON 编辑会 仅针对特定内容进行:settings.json 会保留模型、主题和其他偏好设置;只移除 .hooks 键。

  • JSON 操作需要 jq。如果没有 jq,这些操作会跳过并显示警告(基于文件的移除仍会执行)。

  • 重置后,重新安装以验证干净的设置:

    npx skills@latest add C0nanT/skills
    npx @c0nant/claude-hooks install
    

评论

支持 Markdown