1939869736luosi/codex-sessions-manager

codex-sessions-manager は何をしますか？

Codex/Claude Code スキル + CLI + MCP サーバーによるローカルセッション管理 — 4層クリーンアップ、自動ロールバック、復元可能なゴミ箱、検証機能。

概要

このスキルは、Codex や Claude Code で使用されるローカルセッションを管理するためのツールです。CLI と MCP サーバーを提供し、以下の機能を備えています。

• 4層クリーンアップ: 安全な削除から完全削除まで、4段階のクリーンアップレベルを提供。
• 自動ロールバック: 誤操作時に自動で以前の状態に戻します。
• 復元可能なゴミ箱: 削除したセッションはゴミ箱に移動され、後で復元できます。
• 検証機能: クリーンアップ後、セッションの整合性を検証します。

インストール

npm install -g codex-sessions-manager

または、プロジェクトにローカルインストールします。

npm install codex-sessions-manager

使用法

CLI

# セッションをクリーンアップ（レベル1: 安全なゴミ箱へ移動）
sessions-manager clean --level 1

# セッションを完全削除（レベル4）
sessions-manager clean --level 4

# ゴミ箱からセッションを復元
sessions-manager restore --session-id <session-id>

# セッションの検証
sessions-manager verify --session-id <session-id>

MCP サーバー

MCP サーバーを起動します。

sessions-manager server

その後、MCP 対応のクライアントから以下のツールを利用できます。

• clean_sessions: セッションをクリーンアップします。
• restore_session: ゴミ箱からセッションを復元します。
• verify_session: セッションの整合性を検証します。

設定

環境変数で動作をカスタマイズできます。

環境変数	説明	デフォルト値
SESSIONS_DIR	セッションディレクトリのパス	~/.codex/sessions
TRASH_DIR	ゴミ箱ディレクトリのパス	~/.codex/trash
CLEANUP_LEVEL	デフォルトのクリーンアップレベル	1

ライセンス

MIT