reset-agent-env について
reset-agent-env は、複数のエージェント環境のグローバル設定を調査・削除する Claude スキルです。既定では変更せずに対象を一覧表示し、確認後にバックアップ移動または完全削除を行います。
主な機能
- 01エージェント別の削除対象一覧
- 02繰り返し指定できる対象選択
- 03バックアップ移動または完全削除
- 04JSON 設定の部分的な編集
活用シーン
- 01削除前にグローバル設定を確認
- 02テスト用のクリーンな環境を準備
- 03引き継ぎ前に選択した設定を削除
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ c0nant/ skills --skill reset-agent-envインストール後、Claude Code で/reset-agent-envを入力して読み込まれたか確認します。
同梱ファイルscripts/reset-agent-env.sh
詳細
エージェント環境をリセット
このマシンのエージェント設定(スキル、フック、ルール、MCP サーバー)を、すべてのエージェントハーネスにわたってグローバルに消去します。ゼロからのインストールをテストしたり、クリーンな環境を引き継いだりできます。
破壊的な操作です。スクリプトはデフォルトでドライランになっており、モードを確認するまで何も削除されません。
手順
1. インベントリを作成する(ドライラン)
フラグを付けずに同梱のスクリプトを実行します。存在するものと削除対象をエージェントごとに一覧表示し、変更は行いません。
bash ~/.claude/skills/reset-agent-env/scripts/reset-agent-env.sh
出力をユーザーに提示します。
2. 対象範囲とモードを確認する
次の2点をユーザーに尋ねます。
- 対象のエージェントは? すべて(デフォルト)、または繰り返し指定できる
--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 で再インストールしてください。
対象
| エージェント | 対象 |
|---|---|
| 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が必要です。利用できない場合は警告を表示してスキップします(ファイル単位の削除は実行されます)。 -
リセット後、クリーンなセットアップを確認するために再インストールします。
npx skills@latest add C0nanT/skills npx @c0nant/claude-hooks install