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.
OpenLogs requires Bun as its runtime.
curl -fsSL https://bun.sh/install | bashnpm i -g openlogsPrefix your existing dev command to pipe its output into the stream.
openlogs bun run dev
openlogs npm run dev
openlogs node server.jsFlags
| 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.
Your agent can tail the most recent run at any point during a debugging session, or ask for the most recent matching command.
openlogs tailFlags
| 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 -fThe OpenLogs skill teaches your agent when and how to check logs automatically — no manual prompting needed.
npx skills add https://github.com/charlietlamb/openlogsbun install
bun run devLocal CLI usage without installing globally:
bun packages/ol/src/cli.ts bun run devIf OpenLogs is useful to you, a star helps others find it: github.com/charlietlamb/openlogs