Agent Skills › charlietlamb/openlogs › openlogs-server-logs

openlogs-server-logs

GitHub

用于获取和检查使用 openlogs 或 ol CLI 的项目中的本地服务器日志。支持查看最新运行、特定服务日志、启动错误或堆栈跟踪，并智能解析日志以辅助调试。

skills/openlogs-server-logs/SKILL.md charlietlamb/openlogs

触发场景

询问服务器最近发生了什么需要查看开发服务器输出查找启动错误或堆栈跟踪请求检查后端日志

安装

npx skills add charlietlamb/openlogs --skill openlogs-server-logs -g -y

更多选项

不安装直接使用

npx skills use charlietlamb/openlogs@openlogs-server-logs

指定 Agent (Claude Code)

npx skills add charlietlamb/openlogs --skill openlogs-server-logs -a claude-code -g -y

安装 repo 全部 skill

npx skills add charlietlamb/openlogs --all -g -y

预览 repo 内 skill

npx skills add charlietlamb/openlogs --list

SKILL.md

Frontmatter

{
    "name": "openlogs-server-logs",
    "description": "Fetch and inspect recent local server logs in repos that use openlogs or the `ol` CLI. Use when a user asks what happened in the server, wants recent dev-server output, needs startup errors or stack traces, or asks you to check backend logs from `openlogs tail`, command-specific logs, or `.openlogs\/latest.txt`."
}

Openlogs Server Logs

Use openlogs tail to retrieve recent server logs before asking the user to paste anything. Prefer the cleaned text log unless ANSI or raw terminal bytes matter.

Quick Start

Run openlogs tail -n 200 to inspect the latest run in the project.
If the user mentions a specific command or service, run openlogs tail <query> -n 200 to get the most recent matching run.
Use ol tail -n 200 if the short alias is preferred.
Read .openlogs/latest.txt directly only when file access is simpler than spawning the command and you specifically want the latest overall run.
Use openlogs tail --raw -n 200 only when color codes, cursor control, or exact terminal output matters.
Use openlogs tail -f for live follow mode.

Workflow

Try openlogs tail -n 200.
If the user names a command or service, try openlogs tail <query> -n 200.
If that fails, try ol tail -n 200.
If the CLI is unavailable but the workspace is accessible, read .openlogs/latest.txt or the matching command-specific file in .openlogs/.
If the log directory is missing, check whether the server was started with openlogs <command> or ol <command>.
If it was not, tell the user to relaunch the server through openlogs, then inspect the resulting logs.

Common Commands

openlogs tail -n 100
openlogs tail dev -n 100
openlogs tail server -f
openlogs tail -f
openlogs tail --raw -n 100
openlogs tail --out-dir logs -n 200
openlogs bun dev
ol npm run dev

Interpretation Rules

Prefer the text log for analysis because it strips ANSI noise.
openlogs tail without a query means the latest run overall in the current project.
openlogs tail <query> means the latest run whose command or explicit name contains that query.
Switch to --raw only when the cleaned log hides something important.
Quote the exact failing lines or error block in your answer when useful.
State whether you are looking at the latest captured run or a live-following stream.
If the agent cannot access local gitignored files, ask the user to run openlogs tail -n 200 and paste the output.

Response Shape

Start with the command or file you used.
Summarize the likely issue in 1 to 3 sentences.
Include the most relevant error lines.
If logs are missing, say exactly what command the user should rerun under openlogs.