termlog

termlog

ターミナルセッションをチャットやドキュメントに貼り付けると、すべてが一緒に貼り付けられます。カラーコード、自分自身を何度も書き換えた進行状況バー、そして多くの場合、その途中でスクロールして表示された API キーも含まれます。termlog は、ローカルで一度処理するだけで、生のセッションを共有しやすい Markdown に整えます。

1. ANSI の除去 — CSI、OSC、2 文字のエスケープシーケンスを取り除き、除去した数を記録します
2. キャリッジリターン — 各行で最後の \r より後ろの部分だけを残すため、進行状況バーは最終状態にまとまります
3. 末尾の空白 — 末尾のスペースとタブを取り除きます
4. 秘匿化（デフォルトで有効）— 秘密鍵ブロック、AWS アクセスキー ID、GitHub トークン、Bearer 認証情報、key = value 形式のシークレットを [REDACTED:<kind>] マーカーに置き換えます。置き換えはこのパターン順に適用され、種類ごとに数を記録します
5. 空行 — 3 つ以上連続する改行を、ちょうど 2 つにまとめ、先頭と末尾の空行を削除します

結果は、```console フェンスで囲まれた整形済みテキスト、秘匿化件数、行数の統計情報です。完全にローカルで行われるテキスト変換で、ネットワーク接続も設定も不要です。

CLI

npx @reneturcios/termlog clean --input session.log
npx @reneturcios/termlog clean --input session.log --no-redact
npx @reneturcios/termlog --version

入力ファイルは UTF-8 として読み込まれ、出力オブジェクトは JSON で表示されます。終了コードは、成功時が 0、実行時エラー（入力ファイルを読み取れない場合を含む）時が 1、使用方法のエラー時が 2 です。

MCP サーバー

npx -y @reneturcios/termlog mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "termlog": {
      "command": "npx",
      "args": ["-y", "@reneturcios/termlog", "mcp"]
    }
  }
}

ツール

• clean_terminal_log — 生のターミナルセッションを、共有しやすい整形済み Markdown に変換します。

  • text (string、必須) — 生のターミナルセッションのテキスト
  • redact (boolean、任意、デフォルトは true) — シークレットの秘匿化を適用します

  {markdown, redactions, stats} を返します。内容は、フェンスで囲まれた整形済みテキスト、種類ごとの秘匿化件数（件数が 0 を超える種類のみ。パターン順）、および {input_lines, output_lines, ansi_sequences_removed, total_redactions} です。

Docker

docker run -i ghcr.io/cloudcorprecords/termlog
docker run --rm -v "$PWD:/w" ghcr.io/cloudcorprecords/termlog clean --input /w/session.log

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (pure local, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios