{"_id":"@almanac-ai/agentlogs-cli","name":"@almanac-ai/agentlogs-cli","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@almanac-ai/agentlogs-cli","version":"0.1.0","description":"Query structured local logs your coding agent can read — one trace across frontend and backend.","type":"module","bin":{"agentlogs":"dist/index.js"},"publishConfig":{"access":"public"},"engines":{"node":">=18"},"scripts":{"build":"tsc -p tsconfig.json","dev":"tsx src/index.ts","test":"tsx test/cli.test.ts","prepublishOnly":"npm run build"},"dependencies":{"@almanac-ai/agentlogs-core":"0.1.0"},"keywords":["logging","tracing","debugging","cli","agents","observability"],"license":"MIT","author":{"name":"AlmanacCode"},"repository":{"type":"git","url":"git+https://github.com/AlmanacCode/agentlogs.git","directory":"packages/cli"},"devDependencies":{"@types/node":"^22.19.21","tsx":"^4.19.2","typescript":"^5.6.3"},"_id":"@almanac-ai/agentlogs-cli@0.1.0","gitHead":"85fe240348add6e7128e2efb80f6da3db7e8a6f5","bugs":{"url":"https://github.com/AlmanacCode/agentlogs/issues"},"homepage":"https://github.com/AlmanacCode/agentlogs#readme","_nodeVersion":"21.7.3","_npmVersion":"10.5.0","dist":{"integrity":"sha512-YAyhQnl+q4rkVsasT2bBf1BHLSVCeFEXhXdevHhrpLXZXai60204iopRBOHHrSrE2yvAjUoWtdA8I+5LD16aSw==","shasum":"3ea4d0489ce3a6291e321dca580fbdec74f4fa75","tarball":"https://registry.npmjs.org/@almanac-ai/agentlogs-cli/-/agentlogs-cli-0.1.0.tgz","fileCount":26,"unpackedSize":38272,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFlp8CZY7c6gagtC2iEDB0MLtcYa5CK5DvL8ImLXSv4KAiBwAh/2eZrD64dazXe97+6GowNYoHRw/Tc41ktj0GqPwQ=="}]},"_npmUser":{"name":"reveriedev","email":"reveriedev.one@gmail.com"},"directories":{},"maintainers":[{"name":"reveriedev","email":"reveriedev.one@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentlogs-cli_0.1.0_1781653388947_0.771511007292762"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-16T23:43:08.765Z","0.1.0":"2026-06-16T23:43:09.091Z","modified":"2026-06-16T23:43:09.347Z"},"maintainers":[{"name":"reveriedev","email":"reveriedev.one@gmail.com"}],"description":"Query structured local logs your coding agent can read — one trace across frontend and backend.","homepage":"https://github.com/AlmanacCode/agentlogs#readme","keywords":["logging","tracing","debugging","cli","agents","observability"],"repository":{"type":"git","url":"git+https://github.com/AlmanacCode/agentlogs.git","directory":"packages/cli"},"author":{"name":"AlmanacCode"},"bugs":{"url":"https://github.com/AlmanacCode/agentlogs/issues"},"license":"MIT","readme":"# agentlogs (CLI)\n\nQuery structured local logs your coding agent can read. Reads the JSONL file the\nSDKs write (`~/.agentlogs/app.log`) and answers distinct questions — nothing\noverlaps. See the [repo root](../../README.md) and the [contract](../../SPEC.md).\n\n```bash\nnpm install -g @almanac-ai/agentlogs-cli   # installs the `agentlogs` command\n```\n\n## Commands\n\n```bash\nagentlogs events                 # flat, time-ordered records — \"what happened?\"\nagentlogs trace <id>             # one cross-surface flow, in order\nagentlogs time [name]            # duration of successful timed regions\nagentlogs doctor                 # is logging working? do surfaces correlate?\nagentlogs init                   # detect the stack, print setup\nagentlogs init --write           # also create AGENTS.md when missing\n```\n\nThere is no `recent`, `errors`, `slow`, `tail`, or `latest` command — those are\nfilters and modes on the five above:\n\n```bash\nagentlogs events --since 10m                  # recent\nagentlogs events --level error --since 10m    # errors\nagentlogs events --tail                        # follow live\nagentlogs trace --latest                       # the flow you just triggered\nagentlogs trace tr_18cd --timings              # + nested timing tree\nagentlogs time publish --since 1h              # one operation's stats\n```\n\n## Filters (events, time)\n\n`--since 10m` · `--until <iso>` · `--service backend` · `--logger pages` ·\n`--event 'publish.*'` · `--level error` · `--limit 50` · `--tail` · `--json`\n\n## Output contract\n\nHuman tables by default; `--json` on every command (`--tail --json` streams\nNDJSON). JSON → stdout, diagnostics → stderr. Exit `0` matches / healthy,\n`1` no matches / failed doctor check, `2` usage error. The CLI reports facts —\nit never calls something \"slow\" or \"the bug.\"\n\n## Develop\n\n```bash\nnpm install                 # from the repo root\nnpm run test:cli            # unit tests (tsx)\nnpm run dev -- trace --latest\nnpm run build               # → dist/\n```\n","readmeFilename":"README.md","_rev":"1-d529b83185209e32a5d583f89305d21e"}