logshot
v0.1.2
Published
Local log aggregator: processes, Docker, and browser logs into a SQLite ring buffer with a Fastify API, SSE, and a small web UI.
Maintainers
Readme
logshot
Local development log aggregator (CLI, Fastify API, web UI).
Running the server
From your project root (where logshot.config.json lives):
npx logshotSame as npx logshot serve. See the repository root README.md for configuration, ingest, and development setup.
Agent CLI (read logs and sessions)
With LogShot running elsewhere, use client subcommands to read the ring buffer and sessions over HTTP (same binary as the server):
| Command | Purpose |
| --- | --- |
| logshot logs | Buffered logs as plain text; --json for raw API output |
| logshot sessions | List sessions; --json for raw API output |
| logshot session <id> | Session export as plain text (LLM-friendly) |
Base URL: LOGSHOT_URL, or http://127.0.0.1: + LOGSHOT_PORT, or "port" in ./logshot.config.json (default 7331).
logshot logs --limit 200 --json
logshot sessions
logshot session 1Run logshot --help for options (--limit, --sources, --level, --since, etc.).
Full documentation: README.md at the repository root.
