mcpField
A
agent-tail

agent-tail

github.com/gillkyle开发9365 次安装33 周前更新
代码仓库

关于 agent-tail

agent-tail 是一个命令行工具，可将浏览器控制台输出及开发服务的 stdout、stderr 写入纯文本日志。开发者和编码 Agent 可使用常见日志工具排查运行问题。

主要功能

  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已命名服务的 stdout/stderr（CLI）
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 路由）

Agent 说明

将以下内容添加到项目的 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

将 tmp/ 添加到 .gitignore。如果日志目录未被 gitignore，agent-tail 会在启动时发出警告。

评论

支持 Markdown