{"_id":"@agent-lens/cli","_rev":"2-ef13bb76e3abcb23af2c2bc570eb2dc7","name":"@agent-lens/cli","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.0":{"name":"@agent-lens/cli","version":"0.0.0","keywords":[],"author":"","license":"ISC","_id":"@agent-lens/cli@0.0.0","maintainers":[{"name":"jingkai.zhao","email":"zjk.npm@fastmail.com"}],"dist":{"shasum":"0500bec8b65c59afddd1dcc20bc9a09251f846a5","tarball":"https://registry.npmjs.org/@agent-lens/cli/-/cli-0.0.0.tgz","fileCount":1,"integrity":"sha512-uw+WVOfrMm/WHZF1rTXtZBw5qMRLTi9a81LOzKZVgfY+gSQNwcLTkbKD6V4dscwEGYaftsjONIjT/f5Yj71YGA==","signatures":[{"sig":"MEQCIEl0sG5Z7t5emEWbHjcJgMAuilrxQcyyW1SY2eXc6ekAAiALFImLdrXiuCM0v0RYdF7Pu7dgXPr3jf5ppooAKi8FsA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":229},"main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"jingkai.zhao","email":"zjk.npm@fastmail.com"},"_npmVersion":"10.9.2","directories":{},"_nodeVersion":"22.17.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_0.0.0_1771493376234_0.6077917360169331","host":"s3://npm-registry-packages-npm-production"}},"0.0.1":{"name":"@agent-lens/cli","version":"0.0.1","description":"TS-native AI Agent observability toolkit — zero-config local OTEL receiver and UI for AI agents","type":"module","bin":{"agent-lens":"dist/index.js"},"dependencies":{"commander":"^14.0.0","@agent-lens/server":"0.0.1","@agent-lens/ui":"0.0.1"},"devDependencies":{"@types/node":"^24.3.0"},"keywords":["agent","observability","opentelemetry","otel","tracing","ai","llm","debug"],"author":{"name":"jkzing"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/jkzing/agent-lens.git"},"homepage":"https://github.com/jkzing/agent-lens#readme","bugs":{"url":"https://github.com/jkzing/agent-lens/issues"},"engines":{"node":">=18.0.0"},"scripts":{"dev":"tsx src/index.ts","build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit"},"_id":"@agent-lens/cli@0.0.1","_integrity":"sha512-hymutq9uydeEpO44q2IZM3aqoLQqYehxTYvwEIKPEUHh2rdPZS7aBwPHLetCFmjDSm+zNsebqMp9m70aeIKilQ==","_resolved":"/tmp/release-tarballs/agent-lens-cli-0.0.1.tgz","_from":"file:/tmp/release-tarballs/agent-lens-cli-0.0.1.tgz","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-hymutq9uydeEpO44q2IZM3aqoLQqYehxTYvwEIKPEUHh2rdPZS7aBwPHLetCFmjDSm+zNsebqMp9m70aeIKilQ==","shasum":"29fa9c31345f28af606b1b34a791390a79cb0572","tarball":"https://registry.npmjs.org/@agent-lens/cli/-/cli-0.0.1.tgz","fileCount":3,"unpackedSize":5048,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-lens%2fcli@0.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBegrvw+AgDSA3Ez161e/AT0jGLyynQlveyl4jltjpuoAiEAp8a22N8Ri9UUFYpXwxAnmx2F1t72FOvCUAyJywJt1AQ="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7bb6f33c-f892-4864-82a5-b5d7bdbdac43"}},"directories":{},"maintainers":[{"name":"jingkai.zhao","email":"zjk.npm@fastmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.0.1_1771508260448_0.23932510271904595"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-19T09:29:36.169Z","modified":"2026-02-19T13:37:40.926Z","0.0.0":"2026-02-19T09:29:36.369Z","0.0.1":"2026-02-19T13:37:40.624Z"},"license":"MIT","keywords":["agent","observability","opentelemetry","otel","tracing","ai","llm","debug"],"maintainers":[{"name":"jingkai.zhao","email":"zjk.npm@fastmail.com"}],"readme":"# agent-lens\n\nA TS-native observability toolkit for AI agents.\n\n`agent-lens` provides a local OTLP trace receiver, timeline UI, and debugging views for agent workflows.\n\n## Monorepo packages\n\n- `packages/server` — `@agent-lens/server` (OTLP receiver + SQLite + API)\n- `packages/ui` — `@agent-lens/ui` (React UI)\n- `packages/cli` — `@agent-lens/cli` (CLI entrypoint)\n\n## Local development\n\n```bash\ncd ~/w/gh/jkzing/agent-lens\npnpm install\n```\n\nRun server + UI in two terminals:\n\n```bash\n# terminal A\npnpm --filter @agent-lens/server dev\n\n# terminal B\npnpm --filter @agent-lens/ui dev\n```\n\n- server: `http://localhost:4318`\n- UI dev: `http://localhost:5173` (auto-fallback to next port if occupied)\n\n## Published usage\n\n```bash\nnpx @agent-lens/cli --port 4318\n```\n\n> The executable command remains `agent-lens`.\n\nCLI options:\n\n- `--port <number>` (default `4318`)\n- `--no-open`\n\n## API endpoints\n\n- `POST /v1/traces` — OTLP traces (protobuf/json)\n- `GET /api/traces` — trace summary list\n- `GET /api/traces/:traceId` — spans for a trace\n- `GET /api/spans` — raw span list\n\n## OpenClaw integration\n\nIn OpenClaw config:\n\n```json\n{\n  \"diagnostics\": {\n    \"otel\": {\n      \"endpoint\": \"http://localhost:4318/v1/traces\"\n    }\n  }\n}\n```\n\nThen restart OpenClaw and trigger a few agent turns.\n\n## Release process\n\nSee: [`docs/RELEASE.md`](docs/RELEASE.md)\n\nIt includes:\n\n- version bump rules\n- build/typecheck gates\n- `pnpm pack` dry-run checks\n- npm publish order (`server` → `ui` → `cli`)\n- GitHub Actions release workflow (`.github/workflows/release.yml`)\n\n## Demo\n\n- `docs/demo.png`\n","readmeFilename":"README.md","description":"TS-native AI Agent observability toolkit — zero-config local OTEL receiver and UI for AI agents","homepage":"https://github.com/jkzing/agent-lens#readme","repository":{"type":"git","url":"git+https://github.com/jkzing/agent-lens.git"},"author":{"name":"jkzing"},"bugs":{"url":"https://github.com/jkzing/agent-lens/issues"}}