Community研究&データ分析github.com

cku3987/codex-local-cleanup-skill

~/.codex 配下の古くなった Codex Desktop のプロジェクト/スレッドメタデータを、バックアップ優先の安全チェック付きでクリーンアップします。

codex-local-cleanup-skill とは?

このスキルは、Codex Desktop のローカルメタデータディレクトリ `~/.codex` に蓄積された、古くなったプロジェクトやスレッドのメタデータを安全にクリーンアップするためのツールです。開発者が頻繁に AI エージェント(Codex など)を利用する環境では、経時的に多数のプロジェクトやスレッドのデータが蓄積され、ディスク容量を圧迫したり、パフォーマンスに影響を与える可能性があります。本スキルは、削除前に自動的にバックアップを作成する「バックアップファースト」の安全機構を実装しており、誤った削除によるデータ損失のリスクを大幅に低減します。主に Codex Desktop をサポートしており、ユーザーはコマンド一つで不要なメタデータを安全に整理できます。マニュアル操作に頼らず、AI エージェントの指示としてこのスキルを利用することで、効率的かつ安全にストレージを管理できます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add cku3987/codex-local-cleanup-skill

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

codex-local-cleanup-skill は何をしますか?

~/.codex 配下の古くなった Codex Desktop のプロジェクト/スレッドメタデータを、バックアップ優先の安全チェック付きでクリーンアップします。

概要

このスキルは、Codex Desktop がローカルに保存するプロジェクトやスレッドのメタデータを整理するためのものです。 蓄積された不要なデータを削除することで、ディスク容量を解放し、ツールの応答性を向上させます。

安全性とバックアップ

  • バックアップファースト: 削除を実行する前に、影響を受けるすべてのデータのバックアップが自動的に作成されます。
  • 安全チェック: 削除前に確認プロセスが実行され、重要なデータが誤って削除されるのを防ぎます。
  • 復元可能: バックアップから簡単にデータを復元できます。

使用方法

クリーンアップの実行

codex-cleanup

このコマンドは、以下の処理を自動的に行います:

  1. ~/.codex ディレクトリのスキャン
  2. 古くなったプロジェクトとスレッドのメタデータの特定
  3. 削除対象のリスト表示と確認
  4. バックアップの作成
  5. 選択されたデータの削除

バックアップからの復元

codex-cleanup --restore <backup-path>

サポートされるプラットフォーム

  • Codex Desktop

注意事項

  • このスキルは、現在アクティブなプロジェクトやスレッドのデータは削除しません。
  • バックアップは ~/.codex/backups/ ディレクトリに保存されます。
  • 削除を取り消す必要がある場合は、--restore オプションを使用してバックアップから復元できます。

関連リソース

関連スキル