Repository navigation
Releases
v0.1.5
ClaudeとCodexの整理・復元の起動確認を、指定したプロバイダーだけに限定しました。
run claude/undo claudeはCodexの起動に影響されません。Codex指定時も同様です。両方指定した場合はそれぞれ独立して確認します。- エディタ単独の起動では整理を停止しません。指定プロバイダーのアプリ・CLIが起動中の場合、およびWindowsのnode/electronのコマンドが取得できずプロバイダーを判定できない場合は、安全のため停止します。
- Mac・Windowsとも、ゴミ箱の自動削除設定の読み取り・変更・判定・実行停止を削除。CLIは復元可能な形でゴミ箱へ移動し、その後の削除はOSへ任せます。
- OS自動削除ポリシーだけを理由に設けていたWindowsシステムドライブの制限も撤去しました。パス・リンク・復元整合性の検証は維持しています。
Windowsの通常権限で、Codexが2プロセス起動したまま、検証用Claude履歴のcheck → run → status → undoを実行し、復元ハッシュ一致を確認しました。実際の会話履歴は整理していません。
Mac100件・Windows99件の標準テスト、両OSのネイティブゴミ箱往復試験、strict Clippy、ビルド、インストーラーテストが成功しました。
更新: aiClean update
v0.1.4
Windowsの通常権限で、実行記録や復元用フォルダーへの繰り返し書き込みが Private storage ACL could not be established で失敗する不具合を修正しました。
- ACLの保存を
Set-Aclから Windows PowerShell 5.1 の .NET API に変更。本人とSYSTEMのみの保護済みアクセス権は維持しています。 - 既存フォルダーへのACL再設定と実行記録の繰り返し保存・読み戻しを回帰テストへ追加。Windowsの非昇格ユーザートークンで修正前の失敗と修正後の成功を確認しました。
- Mac98件・Windows97件の標準テスト、strict Clippy、両OSビルドとインストーラーテストをローカルで確認しました。
会話アプリ・CLI・VS Code等の起動中は、従来どおり整理と復元を拒否します。run claude でもCodexを含む両プロバイダーとコードホストを確認します。
更新: aiClean update
aiClean v0.1.3
通常利用向けの表示を修正しました。JSON出力と --json オプションを廃止し、各コマンドの結果を読みやすい日本語で表示します。
check claude codex: サービス別の候補件数・総容量と、全候補の会話名・最終メッセージ日時・容量・IDを表示- 名前は保存済みタイトル、最初のユーザー発言、IDの順で取得。整理対象の選択条件には影響しません
status: 自動実行の実状態、次回予定、前回結果、中断した復元処理を表示- 整理・復元の停止、完了済み、対象なし、失敗、キャンセルを区別
- 改行・ANSI制御・双方向制御文字を除去し、Unicodeで安全に表示
会話アプリが起動中の場合や、OSの30日自動削除設定が未確認の場合は理由を表示します。候補ログの容量を、直後に解放される空き容量として表示しません。整理・復元の安全条件と保存形式は変更していません。
更新:
aiClean update
aiClean --version
aiClean check claude codexMac通常98テスト、ネイティブWindows通常97テスト、両OSのstrict Clippy・ビルド・インストーラーテストが成功しました。WindowsはPowerShell 7からの実行も確認しています。今回、実データの整理・復元は実行していません。
macOSはApple Silicon / Intel universal、Windowsはx64です。Intel実機実行・Apple公証・Authenticode署名は未対応です。OS側の30日自動削除設定を確認できない場合は整理を拒否します。
aiClean v0.1.2
aiCleanの初回公開リリースです。Claude Code・Codexのローカル会話データを整理し、OSのゴミ箱に残っている間は復元できます。CLIのアカウント登録・ログインは不要です。
配布ファイル
aiClean-macos: Apple Silicon / Intel universalaiClean-windows-x64.exe: Windows x64SHA256SUMS: 配布ファイルのSHA-256
インストール
macOS:
curl -fsSL https://raw.githubusercontent.com/ttokunaga-ja/aiClean/main/install.sh | shWindows PowerShell:
irm https://raw.githubusercontent.com/ttokunaga-ja/aiClean/main/install.ps1 | iexインストールだけでは自動整理を有効にしません。新しいターミナルで aiClean --version を確認してください。
主な機能
check claude codex: 整理候補を読み取り専用で確認enable/stop/status: 毎月10日03:30(OSローカル時刻)の予約・停止・状態確認run: 当月1日より前の最終ユーザー送信・アシスタント応答を基準に整理undo: 最後の未復元バッチを復元。中断した処理の回復にも対応--version/update/uninstall: バージョン確認、更新、アンインストール
対象は claude、codex、または両方を明示します。作成・アーカイブ・ファイル更新日時は整理基準にしません。日時不明・未完了・安全に扱えない関係を持つ会話は保持します。
利用条件と検証範囲
会話アプリ・CLI・コードホストが起動中の場合、整理・復元を拒否します。OS側の30日ごみ箱削除設定が検証可能であることも必要です。aiClean自身はごみ箱を空にせず、OS設定も変更しません。Windowsは確認可能なStorage SenseポリシーとOSドライブを対象とし、未確認のGUI設定では整理を拒否します。
ゴミ箱にある間は容量を使用します。SQLiteの削除は領域の再利用であり、ファイルの縮小を保証しません。OS削除後はundoできません。
Mac通常91テスト、Windows通常90テストが成功。Mac/Windowsのネイティブごみ箱とWindowsの専用テストタスクを実機確認しました。Intel版はビルド済みで、Intel/Rosetta上の実行は未検証です。macOSはad-hoc署名(Apple公証なし)、WindowsはAuthenticode署名なしです。
Rust 1.99.0にローカルとCIを固定しています。v0.1.0タグのビルドは新しいClippyルールで停止し、リリース資産は公開されていません。v0.1.1ではGitHub Windows runnerのPowerShell 7由来の環境問題が検出され、配布は停止しました。v0.1.2で子プロセス環境を補正し、アクセス権の要件を維持したまま修正しています。