openlogs
让AI编码代理直接读取你的应用日志
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：openlogs。 它的用途是：让AI编码代理直接读取你的应用日志 完整的 Skill 内容见：https://321skill.com/skills/openlogs/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我检查一下最新的服务器日志，看看为什么接口返回500错误'，它会自动运行 `openlogs tail -n 100` 命令获取最近100行日志，然后分析错误信息并给出修复建议。或者
对AI说：'实时跟踪当前运行的开发服务器日志'，它会执行 `openlogs tail -f` 持续输出日志并实时诊断。
介绍
OpenLogs 是一个轻量级 CLI 工具，专为 AI 编码代理设计，让它们能直接读取你的应用日志。在开发过程中，代理经常因缺乏运行时上下文而给出错误推测，而 OpenLogs 通过捕获终端输出并将日志保存为结构化文件，使代理可以随时 tail 查看最新日志，从而实现精准调试、追踪请求和故障根因分析。
使用非常简单：你只需用 openlogs 前缀运行原有的开发命令（如 openlogs bun run dev），它就会自动将命令的标准输出和错误输出分别写入 .openlogs 目录下的 raw 和 cleaned text 日志文件。代理则可以通过 openlogs tail 命令快速查看最近一次运行的日志，支持按命令名过滤、指定行数、实时跟踪（-f）等。此外，还可以安装配套的 OpenLogs Skill，让代理自动识别何时需要检查日志，无需手动提示。
适合所有使用 AI 编码助手（如 Cursor、Claude、Trae 等）进行开发的开发者，尤其是后端开发、全栈开发和智能体开发者。无论你是调试 API 接口故障、排查线上异常，还是分析复杂的工作流错误，OpenLogs 都能为代理提供实时的运行时上下文，避免无根据的猜测。
建议在项目初期就集成 OpenLogs，让代理习惯使用日志进行调试。注意该工具依赖 Bun 运行时，需要先安装 Bun。另外，它只捕获通过 openlogs 前缀运行的命令输出，对于已运行的服务或远程日志不适用。如果使用 --raw-only 和 --text-only 标志，请确保二选一，不要同时使用。
核心特点
与同类工具不同，OpenLogs 直接捕获终端输出并保存为本地文件，而非依赖外部日志服务或 API；它同时保留原始 PTY 日志和清洗后的纯文本日志，并自动维护最新运行和历史记录，让 AI 代理能以最简命令（openlogs tail）获取实时上下文。
注意事项
不适合需要实时远程日志聚合、日志解析/过滤或集中式日志管理的大型生产环境。
常见问题
如何安装 OpenLogs？
需要先安装 Bun（https://bun.sh），然后运行 `npm i -g openlogs` 全局安装。
如何让 AI 代理自动使用 OpenLogs 检查日志？
运行 `npx skills add https://github.com/charlietlamb/openlogs` 安装配套 Skill，代理会自动在调试时调用 `openlogs tail` 命令。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/openlogs/raw/index.md 读取 openlogs 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/openlogs/raw/index.md（查看排版版本）