logifai GitHub ★ 19
Claude Code 用ログ自動キャプチャ

ターミナルのコピペを、もう終わりにする。

logifai は Claude Code 向けに開発ログを自動で記録。npm run dev 2>&1 | logifai でパイプするだけ。エラーが出たら Claude に聞くだけで、ログを自動検索して答えてくれます。

GitHub で見る クイックスタート
$ brew install tomoyaf/logifai/logifai Homebrew
macOS · Linux · Windows / MIT License / v1.0.0 / 依存ランタイム 0
~/my-app — logifai REC
$ npm run dev 2>&1 | logifai
INFOWeb UI → http://127.0.0.1:3100
INFOready in 842 ms
WARNdeprecated option "legacyWatch"
ERRORModule not found: @/components/Button
at resolve (src/app/page.tsx:3:1)
INFOapi_key=[REDACTED] loaded
claude › 何が問題だった？
→ 直近のログを自動検索
// 01 — 課題

デバッグのたびに、この往復。

Claude Code でデバッグするとき、毎回これをやっていませんか。logifai はステップ 3〜5 を、まるごと消します。

BEFORE — logifai なし
  1. 1dev サーバーを起動する
  2. 2エラーに遭遇する
  3. 3ターミナルを延々とスクロール
  4. 4エラーメッセージをコピー
  5. 5Claude Code に貼り付け
  6. 6「これ何？」と聞く
AFTER — logifai あり
  1. 1npm run dev 2>&1 | logifai
  2. 2エラーに遭遇する
  3. 3Claude に「何が起きた？」と聞く
  4. 4Claude がログを自動検索して回答
スクロールも、コピーも、貼り付けもなし。ログは常にそこにあります。
// 02 — 機能

小さなバイナリ、必要なものは全部。

|

Pipe & Capture

コマンドに 2>&1 | logifai を繋ぐだけ。標準出力も標準エラーも丸ごと記録。

▤

Web UI

127.0.0.1:3100 でライブストリーミング・レベルフィルタ・キーワード検索。

≈

Smart Normalization

JSON を自動検出し ERROR/WARN/INFO/DEBUG を推定。スタックトレースも自動でまとめる。

∗

Automatic Redaction

APIキー・トークン・パスワード・接続文字列を、ディスク保存の前にマスク。

✶

Claude Code Skill

「何が起きた？」と聞くだけで、Claude がログを自動検索して回答。

#

Log References

UI で行を選択 →「Copy Ref」→ 貼り付け。数百行をプロンプトに詰め込む必要なし。

{ }

NDJSON Storage

構造化された 1 行 1 JSON。grep も jq もそのまま使える。

○

Zero Dependencies

単一バイナリで動作。別途ランタイムのインストールは不要。

↻

Self-Update

logifai update が GitHub Releases を確認し、その場で最新版へ。

// 03 — 仕組み

標準入力から、構造化ログまで。

パイプで受け取ったログは、正規化 → マスキング → NDJSON 保存を経て、Web UI とローカルファイルの両方から触れます。

INPUT
stdin
パイプされた出力
↓
NORMALIZER
正規化
  • · JSON 自動検出
  • · レベル推定
  • · スタックトレース結合
  • · CLF / Syslog 解析
↓
REDACTOR
マスキング
機密情報を保存前に除去
↓
OUTPUT
NDJSON
~/.local/state/
logifai/logs/
session-20260208-103045-a1b2c3d4.ndjson 
{
  "timestamp": "2026-02-08T10:30:45.123Z",
  "level": "ERROR",
  "message": "Module not found: @/components/Button",
  "source": "npm-run-dev",
  "session_id": "a1b2c3d4",
  "git_branch": "feature/auth",
  "git_commit": "e91d055",
  "stack": "Error: Module not found\n    at …"
}
手動クエリも自由自在

普通のテキストファイルなので、いつもの道具がそのまま効きます。

grep '"level":"ERROR"' current.ndjson
jq 'select(.level=="ERROR")' …

MCP サーバー不要。Skill が grep / jq で検索します。

// 04 — ログ参照

プロンプトは小さく、
コンテキストは広く。

数百行のログを貼り付ける代わりに、ログ参照（Log References）を使います。必要な行だけを Claude に渡せるので、コンテキストウィンドウを深い分析のために空けておけます。

  1. 1Web UI でエラー行を選択する
  2. 2Copy Ref でコンパクトな URI をコピー
  3. 3Claude Code に貼り付け → 該当行だけ自動取得
logifai · Web UI
41compiling routes…
42ERROR Module not found
…
50at resolve (page.tsx)
55build failed (1 error)
⧉ Copy Ref → logifai://a1b2c3d4:42,50-55
// 05 — クイックスタート

数分で、動きはじめる。

1. インストール — お好みの方法で
Homebrew · macOS / Linux
$ brew install tomoyaf/logifai/logifai
npm · all platforms
$ npm i -g logifai
Shell · macOS / Linux
$ curl -fsSL .../install.sh | sh
PowerShell · Windows
> irm .../install.ps1 | iex

Scoop バケットにも対応: scoop bucket add logifai …

02

ログをキャプチャ

npm run dev 2>&1 | logifai

出力はそのまま画面にも流れます。

03

Skill を導入

/plugin install logifai@…

プラグイン導入が推奨です。

04

Claude に聞く

「直近のエラーは？」

あとは自然に質問するだけ。

// 06 — セキュリティ

ログは出る。秘密は出さない。

機密情報はディスクに書き込まれる前に自動でマスク。すべてローカルに留まり、テレメトリはありません。

自動マスキング対象
Bearer トークンBearer [REDACTED]
OpenAI / Anthropic API キー[REDACTED]
GitHub PAT[REDACTED]
AWS アクセスキー[REDACTED]
DB 接続文字列postgres://[REDACTED]@…
JWT / 秘密鍵ブロック[REDACTED]
汎用シークレットapi_key=[REDACTED]
ファイル権限
700ログディレクトリ（所有者のみ）
600ログファイル（所有者 R/W）
ローカル完結

取得データはすべて自分のマシン上。テレメトリなし。唯一の通信は 1 日 1 回のアップデート確認だけ（CI=true 時はスキップ）。

// 07 — ロードマップ

これからのこと。

Phase 1DONE

パイプ取得・NDJSON・正規化・マスキング・Web UI・Skill・show / cleanup・単一バイナリ・update。

Phase 2PLANNED

logifai exec — 子プロセスモード（TTY 伝播・シグナル転送）。

Phase 3PLANNED

SQLite FTS5 インデックス・.logifai.toml・logifai start。

Phase 4PLANNED

MCP サーバー・セマンティック検索・異常検知。

ログのコピペを、
今日で卒業しよう。

無料・オープンソース。インストールはワンライナーから。

$ brew install tomoyaf/logifai/logifai
GitHub で見る Releases
♥ Patreon で開発を応援する