---
title: "session-reaper"
url: "https://claudemods.dev/ja/builds/session-reaper-e0f4b0"
source: "https://github.com/IT-BAER/claude-forge/tree/main/mods/session-reaper"
source_type: "github"
repo: "https://github.com/IT-BAER/claude-forge/tree/main/mods/session-reaper"
author: "IT-BAER"
author_handle: "IT-BAER"
stars: 1
category: "メモリ・コンテキスト"
categories: ["memory"]
tags: ["hooks", "idle-archive", "process-cleanup", "resource-usage", "session-management", "windows"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add IT-BAER/claude-forge\nclaude plugin install session-reaper@claude-forge"
added: "2026-10-11T20:09:28.484Z"
updated: "2026-10-11T18:44:33Z"
locale: "ja"
content_locale: "ja"
---

# session-reaper

タイムアウトを超えたアイドル状態の Code セッションをアーカイブし、終了したセッションが残したアイドル状態のプロセスツリーを停止する Claude Code デスクトップ MOD。Windows 上で RAM とコミット チャージを解放します。

## Description

session-reaper は、Windows 上の Claude デスクトップ アプリ用の Claude Code MOD です。数分ごとに、(1) 設定可能な制限（デフォルト 60 分）を超えてアイドル状態の Code セッションをアーカイブし、実行中/ピン留め/バックグラウンド ビジーのセッションをスキップし（アーカイブ済みリストから復元可能）、(2) セッションの claude.exe が消えた後に、そのセッションが残したプロセス ツリーを停止します。ただし、すべてのプロセスが十分に古く、CPU がアイドル状態の場合に限り、ブラウザー、エディター、エクスプローラー、ターミナルのセーフリストが適用されます。

動機: 各デスクトップ Code セッションは、独自の約 0.8 GB の claude.exe と、すべての MCP サーバーのコピーを保持します。1 日分の作業で 38 個の claude.exe (15 GB) と 88 個の node.exe (8 GB) が残り、コミット チャージが 47.1/47.6 GB になり、Chrome がクラッシュしました。アイドル状態のセッションをアーカイブし、残存プロセスを停止することで、30 GB に削減されました。

要件: C:\Windows 内の Windows（固定パスの PowerShell と Win32_Process を使用）。アーカイブ ステップにはデスクトップ アプリの Code タブを ccd_session_mgmt サーバー経由で使用（自動モードには permissions.allow に "mcp__ccd_session_mgmt__archive_session" が必要）。他のホストはプロセス ステップのみを実行します。

インストール: /plugin install session-reaper --marketplace IT-BAER/claude-forge

オプション: idleMinutes (60)、orphanMinutes (60)、cpuIdleMs (1000)、intervalMinutes (5)。MOD の実行中に実行中の claude.exe の下で観察されたプロセスのみが追跡されます。

## Install

```
claude plugin marketplace add IT-BAER/claude-forge
claude plugin install session-reaper@claude-forge
```

## Original README

# session-reaper

A Claude Code mod for the Claude desktop app on Windows. Every few minutes it:

1. Archives Code sessions that had no activity for longer than a limit (default 60 minutes). Running and pinned sessions are skipped; the app itself also refuses sessions that are open on screen or still have background work. Archived sessions can be restored from the Archived list.
2. Stops process trees that a session left behind. It records every process a `claude.exe` started (MCP servers, dev servers, shells). Once that `claude.exe` is gone, a tree is stopped only when every process in it is at least 60 minutes old and used almost no CPU since the previous check. `chrome.exe`, `msedge.exe`, `Code.exe`, `claude.exe`, `explorer.exe` and `WindowsTerminal.exe` are never stopped.

Every open session loads the mod, but only one of them does the work (a heartbeat in the plugin store picks it).

## Why it exists

Each desktop Code session keeps its own `claude.exe` (about 0.8 GB) plus its own copy of every MCP server, and none of it goes away while the session sits in the sidebar. On a 32 GB machine, a day of work left 38 `claude.exe` (15 GB) and 88 `node.exe` (8 GB) processes running, the commit charge reached 47.1 of 47.6 GB, and Chrome crashed with an out-of-memory error. Archiving the idle sessions and stopping their leftover processes brought the commit charge down to 30 GB.

## Requirements

- Windows installed in `C:\Windows` (the process step runs `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` by its fixed path and reads `Win32_Process`).
- The Claude desktop app's Code tab. The archive step calls the app's `ccd_session_mgmt` server, which other hosts (CLI, VS Code) do not have; there only the process step runs.
- In auto permission mode the archive call from a mod is refused unless it is allowed. Add this rule to `permissions.allow` in `~/.claude/settings.json`:

  ```json
  "mcp__ccd_session_mgmt__archive_session"
  ```

  The rule also lets Claude archive sessions in any chat without asking.

## Install

```
/plugin install session-reaper --marketplace IT-BAER/claude-forge
```

## Options

| Option | Default | Meaning |
| --- | --- | --- |
| `idleMinutes` | 60 | Archive a session idle for this many minutes |
| `orphanMinutes` | 60 | Minimum age of every process in a left-behind tree |
| `cpuIdleMs` | 1000 | Most CPU time (ms) a process may use between two checks and still count as idle |
| `intervalMinutes` | 5 | How often the active session checks |

Only processes seen under a running `claude.exe` while the mod runs are tracked; trees left behind before the mod loaded are not touched.
