Debugging
Plugin
openlogs
Give coding agents direct access to your logs. OpenLogs turns raw product, API, worker, and infra events into a stream agents can inspect so they can debug failures, trace requests, and answer with real runtime context instead of guesses.
Plugin Signal48/100Fair
maintained45
capable14
documented100
adopted54
Install
$ npx -y skills add charlietlamb/openlogs --agent claude-code
Stats
338
Stars
7
Forks
Maintained
Maintenance
TypeScript
Language
4mo ago
Last commit
6mo ago
Created
Repo: charlietlamb/openlogs
What's inside
README
OpenLogs
Give coding agents direct access to your logs.
OpenLogs turns raw product, API, worker, and infra events into a stream agents can inspect so they can debug failures, trace requests, and answer with real runtime context instead of guesses.
Prerequisites
OpenLogs requires Bun as its runtime.
curl -fsSL https://bun.sh/install | bash
Install
npm i -g openlogs
Setup
01 — Run with openlogs
Prefix your existing dev command to pipe its output into the stream.
openlogs bun run dev
openlogs npm run dev
openlogs node server.js
Flags
| Flag | Description | Default |
|---|---|---|
--out-dir <path> | Directory for log files | .openlogs |
--name <name> | Override the command-specific log name | derived from command |
--raw-only | Skip cleaned text log, write raw only | — |
--text-only | Skip raw PTY log, write text only | — |
--no-history | Don't write timestamped history copies | — |
--print-paths | Print log file paths before running | — |
--raw-onlyand--text-onlyare mutually exclusive.
After each run, OpenLogs updates .openlogs/latest.raw.log and .openlogs/latest.txt for the most recent run in the project, and also keeps a command-specific latest log such as .openlogs/npm-run-dev.txt.
02 — Tell your agent to use the CLI to check the logs
Your agent can tail the most recent run at any point during a debugging session, or ask for the most recent matching command.
openlogs tail
Flags
| Flag | Description | Default |
|---|---|---|
--out-dir <path> | Directory to find log file | .openlogs |
--raw | Read raw PTY log instead of cleaned text | — |
[query] | Match the most recent run whose command or name contains the query | latest run |
[tail args...] | Forwarded to system tail (e.g. -f, -n 50) | — |
openlogs tail -n 100
openlogs tail dev -n 100
openlogs tail server -f
openlogs tail --raw -n 100
openlogs tail -f
03 — Install the skill to make this even easier
The OpenLogs skill teaches your agent when and how to check logs automatically — no manual prompting needed.
npx skills add https://github.com/charlietlamb/openlogs
Development
bun install
bun run dev
Local CLI usage without installing globally:
bun packages/ol/src/cli.ts bun run dev
Contributing
If OpenLogs is useful to you, a star helps others find it: github.com/charlietlamb/openlogs
File tree
FAQ
openlogs is a Claude Code plugin with 1 hand-picked skill for debugging work, indexed on Flowy. Install it with the command on its page. It includes openlogs-server-logs. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is openlogs?
- Give coding agents direct access to your logs. OpenLogs turns raw product, API, worker, and infra events into a stream agents can inspect so they can debug failures, trace requests, and answer with real runtime context instead of guesses.
- How do I install openlogs?
- Run these in Claude Code: npx -y skills add charlietlamb/openlogs --agent claude-code. Then prompt normally.
- Does openlogs auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is openlogs free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it