{"_id":"@allhail/signoz-agent","_rev":"2-d4a150f7e8e56dfb447bd454be08490c","name":"@allhail/signoz-agent","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@allhail/signoz-agent","version":"0.1.0","keywords":["signoz","observability","cli"],"author":{"name":"All Hail AI"},"license":"MIT","_id":"@allhail/signoz-agent@0.1.0","maintainers":[{"name":"akravetz","email":"alex@allhail.ai"}],"homepage":"https://github.com/allhailai/signoz-agent-cli#readme","bugs":{"url":"https://github.com/allhailai/signoz-agent-cli/issues"},"bin":{"signoz-agent":"dist/cli.js"},"dist":{"shasum":"2004e94ef02380e31e0aea9fabb3697f6b3383a5","tarball":"https://registry.npmjs.org/@allhail/signoz-agent/-/signoz-agent-0.1.0.tgz","fileCount":51,"integrity":"sha512-ZFLgJnClr959SKuwE7kSs/t1/hMiwZ76+bQtKzNFqSexXf91PjcKQclnZu1Gp/Cv82yCTLP6stHRke16YCPe8A==","signatures":[{"sig":"MEUCICcgzy0yX69NbxE9MvCxc6ziaO9OseXXqivKnr3mu6D0AiEA5kRp8zwxJ9Qp06A4lUkTNbJN1NsDRhgVWtI/66RI+d4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":170730},"type":"module","engines":{"node":">=20"},"gitHead":"a851156f96d93ee373c96decc4a01e59209ae536","scripts":{"dev":"tsx src/cli.ts","lint":"eslint .","test":"npm run build && vitest run","build":"npm run clean && tsc -p tsconfig.build.json && chmod +x dist/cli.js","clean":"node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"","prepack":"npm run build","type-check":"tsc --noEmit","format:check":"prettier --check ."},"_npmUser":{"name":"akravetz","email":"alex@allhail.ai"},"repository":{"url":"git+https://github.com/allhailai/signoz-agent-cli.git","type":"git"},"_npmVersion":"11.3.0","description":"Agent-first CLI for investigating SigNoz traces and logs.","directories":{},"_nodeVersion":"24.2.0","dependencies":{"commander":"^15.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.0","eslint":"^10.6.0","vitest":"^4.1.9","prettier":"^3.9.4","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.0","typescript-eslint":"^8.62.1"},"_npmOperationalInternal":{"tmp":"tmp/signoz-agent_0.1.0_1783798306034_0.6885811758241764","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@allhail/signoz-agent","version":"0.1.1","description":"Agent-first CLI for investigating SigNoz traces and logs.","type":"module","bin":{"signoz-agent":"dist/cli.js"},"scripts":{"build":"npm run clean && tsc -p tsconfig.build.json && chmod +x dist/cli.js","clean":"node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"","dev":"tsx src/cli.ts","format:check":"prettier --check .","lint":"eslint .","prepack":"npm run build","test":"npm run build && vitest run","type-check":"tsc --noEmit"},"repository":{"type":"git","url":"git+https://github.com/allhailai/signoz-agent-cli.git"},"keywords":["signoz","observability","cli"],"author":{"name":"All Hail AI"},"license":"MIT","bugs":{"url":"https://github.com/allhailai/signoz-agent-cli/issues"},"homepage":"https://github.com/allhailai/signoz-agent-cli#readme","engines":{"node":">=20"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"dependencies":{"commander":"^15.0.0"},"devDependencies":{"@eslint/js":"^10.0.1","@types/node":"^26.1.0","eslint":"^10.6.0","prettier":"^3.9.4","tsx":"^4.23.0","typescript":"^6.0.3","typescript-eslint":"^8.62.1","vitest":"^4.1.9"},"_id":"@allhail/signoz-agent@0.1.1","gitHead":"a851156f96d93ee373c96decc4a01e59209ae536","_nodeVersion":"24.2.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-1OGW05yICSe/xaSrjyRMKrjVrw88XjemrZM9OZNOmZDmEcclqwVx1+TKRAssqlbVC9lCm2UMNyc2VfvRRLPgAQ==","shasum":"2ce2467a0b4417ea7c1edc18026083041a69b020","tarball":"https://registry.npmjs.org/@allhail/signoz-agent/-/signoz-agent-0.1.1.tgz","fileCount":51,"unpackedSize":170730,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDxMGj/HPSzjSy4pplkp77BHDLTf76KL/DufpJoROSQ2wIgfFldOduOofBRd0zwoaFywXh7b4r3nBQwzo4Q6twIdL8="}]},"_npmUser":{"name":"akravetz","email":"alex@allhail.ai"},"directories":{},"maintainers":[{"name":"akravetz","email":"alex@allhail.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/signoz-agent_0.1.1_1783798522467_0.6568761333327164"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T19:31:45.842Z","modified":"2026-07-11T19:35:22.750Z","0.1.0":"2026-07-11T19:31:46.169Z","0.1.1":"2026-07-11T19:35:22.612Z"},"bugs":{"url":"https://github.com/allhailai/signoz-agent-cli/issues"},"author":{"name":"All Hail AI"},"license":"MIT","homepage":"https://github.com/allhailai/signoz-agent-cli#readme","keywords":["signoz","observability","cli"],"repository":{"type":"git","url":"git+https://github.com/allhailai/signoz-agent-cli.git"},"description":"Agent-first CLI for investigating SigNoz traces and logs.","maintainers":[{"name":"akravetz","email":"alex@allhail.ai"}],"readme":"# signoz-agent-cli\n\nAgent-first CLI for discovering SigNoz services, selecting a service, and searching traces/logs.\n\n## Installation\n\nInstall globally:\n\n```bash\nnpm install --global @allhail/signoz-agent\nsignoz-agent --help\n```\n\nOr run a command without installing:\n\n```bash\nnpx @allhail/signoz-agent doctor\n```\n\nFor local development:\n\n```bash\nnpm install\nnpm run build\nnpm link\nsignoz-agent doctor\n```\n\n## Environment\n\nThe CLI reads SigNoz connection settings from environment variables:\n\n- `SIGNOZ_API_URL`: SigNoz API base URL.\n- `SIGNOZ_API_KEY`: SigNoz API key.\n\nUse a local `.env` file or shell exports for development, but do not print or commit secrets. This repo ignores `.env` and `.env.*` files by default. Confirm env vars are present without exposing their values.\n\nExample shell setup with placeholders:\n\n```bash\nexport SIGNOZ_API_URL=\"<your-signoz-api-base-url>\"\nexport SIGNOZ_API_KEY=\"<your-signoz-api-key>\"\n```\n\n## Commands\n\nRun `doctor` first to verify configuration, authentication, and API reachability:\n\n```bash\nsignoz-agent doctor\n```\n\nDiscover recent services, select one, then search traces and logs without repeating `--service`:\n\n```bash\nsignoz-agent services list --since 2h\nsignoz-agent services select checkout-api\nsignoz-agent traces search --since 30m\nsignoz-agent logs search --contains \"timeout\" --since 30m\n```\n\nTrace searches create session-local refs such as `@t1`; log searches create refs such as `@l1`. Inspect spans or fetch correlated logs with a trace ID or trace ref:\n\n```bash\nsignoz-agent trace inspect @t1\nsignoz-agent trace logs @t1\n```\n\nUse direct SigNoz filter expressions when the relevant attribute is known:\n\n```bash\nsignoz-agent traces search --filter \"deployment.environment = 'production'\" --since 2h\nsignoz-agent logs search --filter \"request.id = 'abc123'\" --since 2h\n```\n\nUse log body search for snippets, task IDs, or messages:\n\n```bash\nsignoz-agent logs search --contains \"connection timeout\" --since 2h\nsignoz-agent logs search --contains \"abc123\" --raw\n```\n\nAdd `--json` when an agent or script needs parsed output. Add `--raw` when debugging SigNoz query construction; it prints the request payload and compact response shape, not parsed rows.\n\nIf a ref is missing, rerun the search that created it or pass the full trace ID.\n\n## Validation\n\nBefore opening a PR or handing off changes, run:\n\n```bash\nnpm run format:check\nnpm run type-check\nnpm run lint\nnpm run test\n```\n","readmeFilename":"README.md"}