eSheepDev.AILogExport 1.0.0

AILogExport

Claude CodeおよびCodexのローカルセッションログを、人間が読み返しやすいMarkdownへ変換する.NET CLIツールです。

実ユーザーの発言とAssistantの人間向け本文を抽出し、System／Developer、Thinking／Reasoning、Tool Call／Tool Resultなどの内部情報を除外します。

必要な環境

利用する配布形式によって必要な環境が異なります。

実行方法

NuGet .NET Tool

nuget.orgへの公開後は、グローバルToolとしてインストールできます。

dotnet tool install --global eSheepDev.AILogExport
ailogexport --help

インストール済みのToolを更新する場合は次のコマンドを使用します。

dotnet tool update --global eSheepDev.AILogExport

GitHub Release

GitHub Releasesでは、Windows x64向けに次のZIPを配布します。

利用するZIPを展開し、AILogExport.exe を実行します。

.\AILogExport.exe --help
.\AILogExport.exe claude "C:\Users\...\session.jsonl" -o "D:\session.md"

ソースコード

ソースコードから実行する場合は、以下のようにJSONLを直接指定して変換します。

dotnet run --project src/AILogExport -- claude "C:\Users\...\session.jsonl" -o "D:\session.md"
dotnet run --project src/AILogExport -- codex "C:\Users\...\rollout.jsonl" -o "D:\session.md"

-o を省略した場合は、入力JSONLと同じディレクトリに同名のMarkdownを出力します。出力先が存在する場合、直接指定モードではエラーになります。上書きするには --force または -f を指定します。

入力元だけを指定すると、その入力元のセッションを一覧から選択できます。

dotnet run --project src/AILogExport -- claude
dotnet run --project src/AILogExport -- codex

引数をすべて省略すると、Claude CodeまたはCodexの選択から開始します。

dotnet run --project src/AILogExport

ログ探索ルートを変更する場合は --source-dir を使用します。

dotnet run --project src/AILogExport -- claude --source-dir "D:\ClaudeLogs"

既定のログ探索先

• Claude Code: %USERPROFILE%\.claude\projects
• Codex: %CODEX_HOME%\sessions
• CODEX_HOME 未設定時のCodex: %USERPROFILE%\.codex\sessions

Claude Codeの subagents 配下はVersion 1.0の対象外です。

ビルドとテスト

dotnet build AILogExport.slnx -m:1
dotnet test AILogExport.slnx -m:1

詳細な仕様はdocs/specification.mdを参照してください。

リリース

v1.2.3 または v1.2.3-beta.1 のようなタグをpushすると、GitHub ActionsがReleaseビルド、テスト、nuget.orgへの公開、Windows x64向け実行ファイルの作成、GitHub Releaseへの添付を行います。

初回リリース前に必要なnuget.orgのTrusted Publishing設定と具体的な手順はdocs/releasing.mdを参照してください。