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 Signal55/100Fair
maintained64
capable14
documented100
adopted54
Install
$ npx -y skills add charlietlamb/openlogs --agent claude-code
Stats
338
Stars
7
Forks
Maintained
Maintenance
TypeScript
Language
2mo ago
Last commit
5mo 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
charlietlamb/openlogsView on GitHub
.gitignore
.husky/
pre-commit
apps/
web/
.agents/
skills/
next-best-practices/
async-patterns.md
bundling.md
data-patterns.md
debug-tricks.md
directives.md
error-handling.md
file-conventions.md
font.md
functions.md
hydration-error.md
image.md
metadata.md
parallel-routes.md
route-handlers.md
rsc-boundaries.md
runtime-selection.md
scripts.md
self-hosting.md
SKILL.md
suspense-boundaries.md
next-cache-components/
SKILL.md
next-upgrade/
SKILL.md
vercel-composition-patterns/
AGENTS.md
README.md
rules/
architecture-avoid-boolean-props.md
architecture-compound-components.md
patterns-children-over-render-props.md
patterns-explicit-variants.md
react19-no-forwardref.md
state-context-interface.md
state-decouple-implementation.md
state-lift-state.md
SKILL.md
vercel-react-best-practices/
AGENTS.md
README.md
rules/
advanced-event-handler-refs.md
advanced-init-once.md
advanced-use-latest.md
async-api-routes.md
async-defer-await.md
async-dependencies.md
async-parallel.md
async-suspense-boundaries.md
bundle-barrel-imports.md
bundle-conditional.md
bundle-defer-third-party.md
bundle-dynamic-imports.md
bundle-preload.md
client-event-listeners.md
client-localstorage-schema.md
client-passive-event-listeners.md
client-swr-dedup.md
js-batch-dom-css.md
js-cache-function-results.md
js-cache-property-access.md
js-cache-storage.md
js-combine-iterations.md
js-early-exit.md
js-hoist-regexp.md
js-index-maps.md
js-length-check-first.md
js-min-max-loop.md
js-set-map-lookups.md
js-tosorted-immutable.md
rendering-activity.md
rendering-animate-svg-wrapper.md
rendering-conditional-render.md
rendering-content-visibility.md
rendering-hoist-jsx.md
rendering-hydration-no-flicker.md
rendering-hydration-suppress-warning.md
rendering-svg-precision.md
rendering-usetransition-loading.md
rerender-defer-reads.md
rerender-dependencies.md
rerender-derived-state-no-effect.md
rerender-derived-state.md
rerender-functional-setstate.md
rerender-lazy-state-init.md
rerender-memo-with-default-value.md
rerender-memo.md
rerender-move-effect-to-event.md
rerender-simple-expression-in-memo.md
rerender-transitions.md
rerender-use-ref-transient-values.md
server-after-nonblocking.md
server-auth-actions.md
server-cache-lru.md
server-cache-react.md
server-dedup-props.md
server-parallel-fetching.md
server-serialization.md
SKILL.md
vercel-react-native-skills/
AGENTS.md
README.md
rules/
animation-derived-value.md
animation-gesture-detector-press.md
animation-gpu-properties.md
design-system-compound-components.md
fonts-config-plugin.md
imports-design-system-folder.md
js-hoist-intl.md
list-performance-callbacks.md
list-performance-function-references.md
list-performance-images.md
list-performance-inline-objects.md
list-performance-item-expensive.md
list-performance-item-memo.md
list-performance-item-types.md
list-performance-virtualize.md
monorepo-native-deps-in-app.md
monorepo-single-dependency-versions.md
navigation-native-navigators.md
react-compiler-destructure-functions.md
react-compiler-reanimated-shared-values.md
react-state-dispatcher.md
react-state-fallback.md
react-state-minimize.md
rendering-no-falsy-and.md
rendering-text-in-text-component.md
scroll-position-no-state.md
state-ground-truth.md
ui-expo-image.md
ui-image-gallery.md
ui-measure-views.md
ui-menus.md
ui-native-modals.md
ui-pressable.md
ui-safe-area-scroll.md
ui-scrollview-content-inset.md
ui-styling.md
SKILL.md
web-design-guidelines/
SKILL.md
.gitignore
app/
agent-strip.tsx
favicon.ico
globals.css
layout.tsx
opengraph-image.png
page.tsx
providers.tsx
theme.css
twitter-image.png
components/
accordion-trigger.tsx
copyable-command.tsx
flags-accordion.tsx
hero-cta.tsx
icons/
github-icon.tsx
logs/
index.tsx
log-data.ts
terminal-layer.tsx
nav-header.tsx
setup-guide.tsx
skill-accordion.tsx
lib/
cn.ts
constants.ts
skill-content.ts
use-copy-to-clipboard.ts
next.config.ts
package.json
postcss.config.mjs
public/
agents/
amp.svg
antigravity.svg
claude-code.svg
clawdbot.svg
cline.svg
codex.svg
copilot.svg
cursor.svg
droid.svg
gemini.svg
goose.svg
kilo.svg
kiro-cli.svg
opencode.svg
roo.svg
trae.svg
vscode.svg
windsurf.svg
file.svg
globe.svg
next.svg
opengraph.png
vercel.svg
window.svg
README.md
skills/
skills-lock.json
next-best-practices
next-cache-components
next-upgrade
vercel-composition-patterns
vercel-react-best-practices
vercel-react-native-skills
web-design-guidelines
tsconfig.json
biome.jsonc
bun.lock
package.json
packages/
ol/
package.json
src/
cli.test.ts
cli.ts
collector.ts
shared.test.ts
shared.ts
README.md
skills/
openlogs-server-logs/
agents/
openai.yaml
SKILL.md
turbo.jsonFAQ
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.