mcpField
A
agent-tail

agent-tail

github.com/gillkyle開発9365 回インストール33 週間前に更新
リポジトリ

agent-tail について

agent-tail は、ブラウザーのコンソール出力と開発サービスの stdout、stderr をプレーンなログファイルに記録するコマンドラインツールです。開発者やコーディングエージェントが、使い慣れたログツールで実行時の問題を調べられます。

主な機能

  1. 01ブラウザーのコンソールメッセージとエラーを記録
  2. 02サービスの stdout と stderr を保存
  3. 03複数サービスのログを統合
  4. 04セッションまたはサービス単位でログを表示
  5. 05ログ行の絞り込みと端末出力の抑制

活用シーン

  1. 01開発中のブラウザーエラーを調査
  2. 02複数の開発サービスの出力を確認
  3. 03最新セッションのログを追跡
  4. 04警告やエラーをログから検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gillkyle/agent-tail --skill agent-tail

インストール後、Claude Code で/agent-tailを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cli-reference.md
setup-nextjs.md
setup-vite.md

詳細

agent-tail

ブラウザーのコンソール出力と開発サーバーの stdout/stderr をディスク上のプレーンなログファイルに書き出すので、直接 grep や tail で読み取れます。

ログの読み取り

agent-tail tail -n 200
agent-tail tail browser -n 50
agent-tail tail -f
grep -ri "error\|warn" tmp/logs/latest/
tail -50 tmp/logs/latest/browser.log
tail -f tmp/logs/latest/*.log

ファイルパスを直接指定する場合は、通常の tail を使います。CLI に最新のセッションを解決させ、-f や -n 200 などのフラグを tail に直接渡したい場合は、agent-tail tail を使います。

ログファイル

ログは tmp/logs/latest/（再起動後も変わらない、最新のセッションディレクトリへのシンボリックリンク）に保存されます。

ファイルソース
browser.logブラウザーの console.*、未処理のエラー／拒否（Vite または Next.js のプラグイン）
<name>.log名前付きサービス（CLI）の stdout/stderr
combined.logすべてのサービスをインターリーブし、[name] をプレフィックスとして付与（CLI）

ログ形式

[HH:MM:SS.mmm] [LEVEL  ] message (source-url)
    stack trace indented with 4 spaces

レベル名は大文字に変換され、7 文字分にパディングされます（LOG 、WARN 、ERROR ）。

CLI

agent-tail run 'fe: npm run dev' 'api: uv run server'   # run multiple services
agent-tail wrap api -- uv run fastapi-server              # add to existing session
agent-tail init                                           # create session only
tail -f tmp/logs/latest/*.log                             # tail directly by path
agent-tail tail -f                                        # tail all logs in latest session
agent-tail tail browser -n 50                             # tail one log in latest session

フラグ（すべてのコマンドで使用できます）：

--log-dir <dir>       Log directory (default: tmp/logs)
--max-sessions <n>    Max sessions to keep (default: 10)
--no-combined         Don't write combined.log
--exclude <pattern>   Exclude lines matching pattern (repeatable, /regex/ or substring)
--mute <name>         Mute service from terminal + combined.log (still logs to <name>.log)

詳細については references/cli-reference.md を参照してください。

セットアップ

npm install -D agent-tail
  • CLI（すべてのスタック）： 開発スクリプトに agent-tail run 'name: command' を追加します
  • Vite： references/setup-vite.md を参照してください
  • Next.js： references/setup-nextjs.md（設定ラッパー＋レイアウトスクリプト＋API ルート）を参照してください

エージェント向けの指示

プロジェクトの CLAUDE.md、.cursorrules、または同等のファイルに追加します。

## Dev Logs

All dev server output is captured to `tmp/logs/`. The latest session
is symlinked at `tmp/logs/latest/`.

When debugging, check logs before guessing about runtime behavior:

    grep -ri "error\|warn" tmp/logs/latest/
    tail -50 tmp/logs/latest/browser.log
    agent-tail tail browser -n 50

.gitignore

.gitignore に tmp/ を追加します。ログディレクトリが gitignore 対象になっていない場合、agent-tail は起動時に警告します。

コメント

Markdown 対応