{"_id":"@alexgorbatchev/agentation-cli","_rev":"5-61802b37a4629d817fa2ef565b03c584","name":"@alexgorbatchev/agentation-cli","dist-tags":{"latest":"1.0.5"},"versions":{"0.0.1":{"name":"@alexgorbatchev/agentation-cli","version":"0.0.1","_id":"@alexgorbatchev/agentation-cli@0.0.1","maintainers":[{"name":"alexgorbatchev","email":"alex.gorbatchev@gmail.com"}],"dist":{"shasum":"81effbfbf8b1a08673f96c9aca62a4ab81e83f1b","tarball":"https://registry.npmjs.org/@alexgorbatchev/agentation-cli/-/agentation-cli-0.0.1.tgz","fileCount":1,"integrity":"sha512-FRMVcrylHcE063BNeT+pu1oNhZ0L5v/qo+7DFk8cJC2ZiF6Ar7vHrGPlAxzPBCy7RQgOrAA8f0cY++lMPphHIw==","signatures":[{"sig":"MEQCIGhTuEgCovFbluTNpA2cMi7BjDSKIcAL5/323grjipXhAiArH5BUdEauh11ULz0dpjzGivrgG5TvNq/5jqT9esWEdw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69},"_npmUser":{"name":"alexgorbatchev","email":"alex.gorbatchev@gmail.com"},"_npmVersion":"11.9.0","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentation-cli_0.0.1_1774121861258_0.10686446813681494","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@alexgorbatchev/agentation-cli","version":"1.0.1","license":"MIT","_id":"@alexgorbatchev/agentation-cli@1.0.1","maintainers":[{"name":"alexgorbatchev","email":"alex.gorbatchev@gmail.com"}],"homepage":"https://github.com/alexgorbatchev/agentation-cli#readme","bugs":{"url":"https://github.com/alexgorbatchev/agentation-cli/issues"},"os":["darwin","linux"],"bin":{"agentation":"bin/agentation.js"},"cpu":["x64","arm64"],"dist":{"shasum":"f2006e41679c7dc41d587267a06adc3269cb6173","tarball":"https://registry.npmjs.org/@alexgorbatchev/agentation-cli/-/agentation-cli-1.0.1.tgz","fileCount":7,"integrity":"sha512-7/t+ZVE5f5G1TDy5sRAiZTQNm2DeftPZGBS6syrKRBKfEdUS6fJsU02r7AiQUhbbsDTF2vA4HOzgFCI2FF3aQA==","signatures":[{"sig":"MEUCIQDiAmqx5SEznQxzcsQYfqeccLnuV8T5hBb1hMRokntB1wIgcz8b2KOWlpH3hDPCuk08zdzJ/GSdk50NfMswuf14p9c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alexgorbatchev%2fagentation-cli@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":17787},"engines":{"node":">=18"},"gitHead":"d1bbb76379eb32df5c07af25814c3630bd51206c","scripts":{"postinstall":"node ./scripts/install.js","set:version":"node ./scripts/setPackageVersions.js","pack:wrapper":"npm pack","pack:platforms":"npm pack ./npm/darwin-x64 && npm pack ./npm/darwin-arm64 && npm pack ./npm/linux-x64 && npm pack ./npm/linux-arm64","stage:npm-packages":"node ./scripts/stageNpmPackages.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7fe34220-3392-4390-81fb-2bfc12ca3c86"}},"repository":{"url":"git+https://github.com/alexgorbatchev/agentation-cli.git","type":"git"},"_npmVersion":"11.9.0","description":"Agentation CLI with npm-native platform binaries","directories":{},"_nodeVersion":"24.14.0","dependencies":{"tar":"^7.4.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"optionalDependencies":{"@alexgorbatchev/agentation-cli-linux-x64":"1.0.1","@alexgorbatchev/agentation-cli-darwin-x64":"1.0.1","@alexgorbatchev/agentation-cli-linux-arm64":"1.0.1","@alexgorbatchev/agentation-cli-darwin-arm64":"1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/agentation-cli_1.0.1_1774125309838_0.06529209430397276","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@alexgorbatchev/agentation-cli","version":"1.0.3","license":"MIT","_id":"@alexgorbatchev/agentation-cli@1.0.3","maintainers":[{"name":"alexgorbatchev","email":"alex.gorbatchev@gmail.com"}],"homepage":"https://github.com/alexgorbatchev/agentation-cli#readme","bugs":{"url":"https://github.com/alexgorbatchev/agentation-cli/issues"},"os":["darwin","linux"],"bin":{"agentation":"bin/agentation.js"},"cpu":["x64","arm64"],"dist":{"shasum":"3825dce40db002e506998573b30a727d8360b62b","tarball":"https://registry.npmjs.org/@alexgorbatchev/agentation-cli/-/agentation-cli-1.0.3.tgz","fileCount":7,"integrity":"sha512-2y52cEh6vw3E5jN4c+W2SW9ZvlciVeue2Kmllsj1ZhUXrfHLE6BHe5YPtP1QPq7UXyQrqSzU+RZvA/Ccyt3l7A==","signatures":[{"sig":"MEQCIG+ym68WHjeILbC5NlKPhru+kvyLYSBYGPP/Fr/DsSl8AiBee4XkYAx8iK20YHIkV88q0YzDOkgk6fitq1b0+e+PnA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alexgorbatchev%2fagentation-cli@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":17791},"engines":{"node":">=18"},"gitHead":"5a536b9b12332bedd9a2bdf79556a449d4d7aaff","scripts":{"postinstall":"node ./scripts/install.js","set:version":"node ./scripts/setPackageVersions.js","pack:wrapper":"npm pack","pack:platforms":"npm pack ./npm/darwin-x64 && npm pack ./npm/darwin-arm64 && npm pack ./npm/linux-x64 && npm pack ./npm/linux-arm64","stage:npm-packages":"node ./scripts/stageNpmPackages.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7fe34220-3392-4390-81fb-2bfc12ca3c86"}},"repository":{"url":"git+https://github.com/alexgorbatchev/agentation-cli.git","type":"git"},"_npmVersion":"11.9.0","description":"Agentation CLI with npm-native platform binaries","directories":{},"_nodeVersion":"24.14.0","dependencies":{"tar":"^7.4.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"optionalDependencies":{"@alexgorbatchev/agentation-cli-linux-x64":"1.0.3","@alexgorbatchev/agentation-cli-darwin-x64":"1.0.3","@alexgorbatchev/agentation-cli-linux-arm64":"1.0.3","@alexgorbatchev/agentation-cli-darwin-arm64":"1.0.3"},"_npmOperationalInternal":{"tmp":"tmp/agentation-cli_1.0.3_1774233515250_0.31056264119862464","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@alexgorbatchev/agentation-cli","version":"1.0.4","license":"MIT","_id":"@alexgorbatchev/agentation-cli@1.0.4","maintainers":[{"name":"alexgorbatchev","email":"alex.gorbatchev@gmail.com"}],"homepage":"https://github.com/alexgorbatchev/agentation-cli#readme","bugs":{"url":"https://github.com/alexgorbatchev/agentation-cli/issues"},"os":["darwin","linux"],"bin":{"agentation":"bin/agentation.js"},"cpu":["x64","arm64"],"dist":{"shasum":"407bf3f654dc3feb59f7ecc778c7c55e9f803c7c","tarball":"https://registry.npmjs.org/@alexgorbatchev/agentation-cli/-/agentation-cli-1.0.4.tgz","fileCount":7,"integrity":"sha512-Y0/TixYHUtv7Hx9z3BX0pXd+ReJBZ19GPJ9s/AAJYC9BfJrnX1zmdqr2IHHCZEsBUG2Kh93f72359ReK68QstA==","signatures":[{"sig":"MEQCIBp2p4knBlHcQw8ucDTmK+mw6Z5yrmUBMue0NCl8IgGFAiAlPMAfiTzYK1K3Er/ZAsJKQj/clGR7IgtfBIznBUhlrw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alexgorbatchev%2fagentation-cli@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":17858},"engines":{"node":">=18"},"gitHead":"ccfff23a15fa17cab5e3d84c719dead5466f5e63","scripts":{"postinstall":"node ./scripts/install.js","set:version":"node ./scripts/setPackageVersions.js","pack:wrapper":"npm pack","pack:platforms":"npm pack ./npm/darwin-x64 && npm pack ./npm/darwin-arm64 && npm pack ./npm/linux-x64 && npm pack ./npm/linux-arm64","stage:npm-packages":"node ./scripts/stageNpmPackages.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7fe34220-3392-4390-81fb-2bfc12ca3c86"}},"repository":{"url":"git+https://github.com/alexgorbatchev/agentation-cli.git","type":"git"},"_npmVersion":"11.9.0","description":"Agentation CLI with npm-native platform binaries","directories":{},"_nodeVersion":"24.14.0","dependencies":{"tar":"^7.4.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"optionalDependencies":{"@alexgorbatchev/agentation-cli-linux-x64":"1.0.4","@alexgorbatchev/agentation-cli-darwin-x64":"1.0.4","@alexgorbatchev/agentation-cli-linux-arm64":"1.0.4","@alexgorbatchev/agentation-cli-darwin-arm64":"1.0.4"},"_npmOperationalInternal":{"tmp":"tmp/agentation-cli_1.0.4_1774239349392_0.3601381919704343","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@alexgorbatchev/agentation-cli","version":"1.0.5","description":"Agentation CLI with npm-native platform binaries","license":"MIT","repository":{"type":"git","url":"git+https://github.com/alexgorbatchev/agentation-cli.git"},"homepage":"https://github.com/alexgorbatchev/agentation-cli#readme","bugs":{"url":"https://github.com/alexgorbatchev/agentation-cli/issues"},"bin":{"agentation":"bin/agentation.js"},"os":["darwin","linux"],"cpu":["x64","arm64"],"engines":{"node":">=18"},"scripts":{"postinstall":"node ./scripts/install.js","set:version":"node ./scripts/setPackageVersions.js","stage:npm-packages":"node ./scripts/stageNpmPackages.js","pack:wrapper":"npm pack","pack:platforms":"npm pack ./npm/darwin-x64 && npm pack ./npm/darwin-arm64 && npm pack ./npm/linux-x64 && npm pack ./npm/linux-arm64"},"dependencies":{"tar":"^7.4.3"},"optionalDependencies":{"@alexgorbatchev/agentation-cli-darwin-x64":"1.0.5","@alexgorbatchev/agentation-cli-darwin-arm64":"1.0.5","@alexgorbatchev/agentation-cli-linux-x64":"1.0.5","@alexgorbatchev/agentation-cli-linux-arm64":"1.0.5"},"publishConfig":{"access":"public"},"gitHead":"7c3bf2bea1d5e8e3d1d2efe76578155952816305","_id":"@alexgorbatchev/agentation-cli@1.0.5","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-WVFwJxlGM1hPXTvJ6ChRcfYT3WkDQynjU/xMlj+Zyo0hfXnJAUW8dEXU/FjVxRv/+jEa/7u8ll1ZUyywYTZVzw==","shasum":"3a8ffd120d5ce514255ca6ff0c1e78b095f1b1f9","tarball":"https://registry.npmjs.org/@alexgorbatchev/agentation-cli/-/agentation-cli-1.0.5.tgz","fileCount":7,"unpackedSize":18211,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alexgorbatchev%2fagentation-cli@1.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCSDn/KIJZ7C5Id5OGNoZtmONySKPV9KNxElVW1OTzTuwIhAOCohBfzSdspvoWX6DI/zUvh6WCOCgLWYqeIejxU6uZS"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7fe34220-3392-4390-81fb-2bfc12ca3c86"}},"directories":{},"maintainers":[{"name":"alexgorbatchev","email":"alex.gorbatchev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentation-cli_1.0.5_1774566101487_0.9295378782948145"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-21T19:37:41.191Z","modified":"2026-03-26T23:01:41.947Z","0.0.1":"2026-03-21T19:37:41.401Z","1.0.1":"2026-03-21T20:35:10.211Z","1.0.3":"2026-03-23T02:38:35.398Z","1.0.4":"2026-03-23T04:15:49.545Z","1.0.5":"2026-03-26T23:01:41.653Z"},"bugs":{"url":"https://github.com/alexgorbatchev/agentation-cli/issues"},"license":"MIT","homepage":"https://github.com/alexgorbatchev/agentation-cli#readme","repository":{"type":"git","url":"git+https://github.com/alexgorbatchev/agentation-cli.git"},"description":"Agentation CLI with npm-native platform binaries","maintainers":[{"name":"alexgorbatchev","email":"alex.gorbatchev@gmail.com"}],"readme":"# Agentation Fork CLI\n\nCLI companion for the Agentation Fork.\n\n## Related repositories\n\n- [Agentation Fork docs](https://agentation.dev)\n- [Agentation Fork](https://github.com/alexgorbatchev/agentation)\n- [Agentation Skills](https://github.com/alexgorbatchev/agentation-skills)\n- [pi-agentation](https://github.com/alexgorbatchev/pi-agentation)\n\n## Install\n\n### Install with npm\n\n```bash\nnpm install -g @alexgorbatchev/agentation-cli\n```\n\nFor the supported project-local workflow used by the docs site and the frontend package README, you can also install it\nas a dev dependency and invoke it with `npx`:\n\n```bash\nnpm install -D @alexgorbatchev/agentation-cli\nnpx agentation start\n```\n\nThis repository now ships the CLI as:\n\n- one wrapper package: `@alexgorbatchev/agentation-cli`\n- four platform packages:\n  - `@alexgorbatchev/agentation-cli-darwin-x64`\n  - `@alexgorbatchev/agentation-cli-darwin-arm64`\n  - `@alexgorbatchev/agentation-cli-linux-x64`\n  - `@alexgorbatchev/agentation-cli-linux-arm64`\n\nThe wrapper package uses `optionalDependencies` so npm only installs the matching platform package for the current machine. If optional dependencies are disabled during install, the wrapper falls back to downloading the matching GitHub release archive for the same version and verifies it against the published `checksums.txt` file.\n\nYou can point fallback downloads at a mirror by setting:\n\n```bash\nAGENTATION_CLI_BINARY_HOST=https://github.example.com/alexgorbatchev/agentation-cli/releases/download/v<version> npm install -g @alexgorbatchev/agentation-cli\n```\n\n### Install with Go\n\n```bash\ngo install github.com/alexgorbatchev/agentation-cli/cmd/agentation@latest\n```\n\n## Build from source\n\n```bash\ngo build ./cmd/agentation\n```\n\nOr with `just` from this directory:\n\n```bash\njust build\n```\n\n## Usage\n\n```bash\nagentation <command>\n```\n\nCommands:\n\n- `ack <annotation-id> [--base-url <url>] [--json]`\n- `dismiss <annotation-id> [--base-url <url>] --reason \"...\" [--json]`\n- `generate --fix-loop-skill`\n- `pending <project-id> [--base-url <url>] [--json]`\n- `project <project-id> [--base-url <url>] [--json]`\n- `projects [--base-url <url>]` (project IDs active in the last 24 hours)\n- `reply <annotation-id> [--base-url <url>] --message \"...\" [--json]`\n- `resolve <annotation-id> [--base-url <url>] [--summary \"...\"] [--json]`\n- `start [--server-addr host:port|0] [--router-addr host:port|0] [--foreground|--background]`\n- `status`\n- `stop`\n- `watch <project-id> [--base-url <url>] [--timeout 300] [--json]`\n\nAdd `--json` to API/data commands for machine-readable output.\n\nYou can set a default API endpoint with:\n\n```bash\nAGENTATION_BASE_URL=http://127.0.0.1:4747 agentation pending project-alpha --json\n```\n\n## Project-scoped filtering\n\nProject scoping is required for `pending` and `watch`.\nUse `projects` to discover project IDs with activity in the last 24 hours.\n\n```bash\nagentation projects --json\nagentation project project-alpha --json\nagentation pending project-alpha --json\nagentation watch project-alpha --timeout 300 --json\n```\n\n## Router token auth (`AGENTATION_ROUTER_TOKEN`)\n\nWhen `AGENTATION_ROUTER_TOKEN` is set, router requests that can mutate session state or trigger editor side effects require auth:\n\n- `POST /register`\n- `POST /unregister`\n- `GET|POST /open`\n\nProvide the token using either:\n\n- `X-Agentation-Token: <token>`\n- `Authorization: Bearer <token>`\n\n`/ping` remains unauthenticated for liveness/session resolution checks.\n\n## SSE delivery semantics (`watch` / `/events`)\n\n`agentation watch` first drains `/pending`, then listens on SSE (`/events?agent=true` or `/sessions/{id}/events?agent=true`) and returns as soon as the next annotation or human thread reply arrives.\n\nOperational guarantees/limits:\n\n- Persisted stream events include a monotonically increasing sequence ID (`id` in SSE frames). Bootstrap sync snapshots may use sequence `0` before live events begin.\n- Server keepalives are emitted as SSE comments (`: ping`) every ~30s.\n- Delivery uses explicit backpressure semantics to avoid silent event drops under load.\n- Trade-off: a consistently slow consumer can increase end-to-end latency while pressure is applied.\n- `/pending` remains the source of truth for reconciliation if a stream disconnects.\n\n## Skill generation helpers\n\n```bash\nagentation generate --fix-loop-skill\n```\n\nThis prints the embedded Agentation fix-loop skill markdown from the CLI binary.\n\n## Lifecycle management\n\n```bash\n# Start both services (default)\nagentation start\n\n# Start with explicit addresses\nagentation start --server-addr 127.0.0.1:4747 --router-addr 127.0.0.1:8787\n\n# Disable one service by setting address to 0\nAGENTATION_SERVER_ADDR=0 agentation start\nAGENTATION_ROUTER_ADDR=0 agentation start\n\nagentation status\nagentation stop\n```\n\nNotes:\n\n- `start` runs as a **single PID** that manages both server and router.\n- By default, both services start.\n- Set `AGENTATION_SERVER_ADDR=0` to disable server, or `AGENTATION_ROUTER_ADDR=0` to disable router.\n- `--server-addr` / `--router-addr` override environment values.\n- `--foreground` runs in current shell; `--background` daemonizes.\n\n## Environment variables\n\n- `AGENTATION_BASE_URL` (default base URL for API commands: `http://localhost:4747`)\n- `AGENTATION_STORE` (`sqlite` by default, set to `memory` for in-memory mode)\n- `AGENTATION_DB_PATH` (explicit SQLite DB path override)\n- `XDG_DATA_HOME` (used for default SQLite location when `AGENTATION_DB_PATH` is unset)\n- `AGENTATION_SERVER_ADDR` (default server address for `agentation start`; use `0` to disable)\n- `AGENTATION_ROUTER_ADDR` (default router address for `agentation start`; use `0` to disable)\n- `AGENTATION_PID_FILE` (override single PID file for stack lifecycle)\n- `AGENTATION_LOG_FILE` (override stack supervisor log file for background mode)\n- `AGENTATION_SERVER_LOG_FILE` (override server log file)\n- `AGENTATION_ROUTER_LOG_FILE` (override router log file)\n- `AGENTATION_ROUTER_ADDRESS` (legacy fallback router address if `AGENTATION_ROUTER_ADDR` is unset)\n- `AGENTATION_ROUTER_TOKEN` (optional auth token; when set, required by `/register`, `/unregister`, and `/open`)\n- `AGENTATION_ROUTER_BODY_LIMIT` (max router request body size)\n- `AGENTATION_ROUTER_FORWARD_TIMEOUT` (router forward timeout)\n- `AGENTATION_ROUTER_READ_TIMEOUT` / `AGENTATION_ROUTER_WRITE_TIMEOUT`\n- `AGENTATION_ROUTER_READ_HEADER_TIMEOUT` / `AGENTATION_ROUTER_IDLE_TIMEOUT`\n- `AGENTATION_ROUTER_SESSION_STALE_AFTER`\n- `AGENTATION_ROUTER_ALLOW_ABSOLUTE_PATHS`\n- `AGENTATION_ROUTER_ENFORCE_ROOT_BOUNDS`\n- `AGENTATION_CLI_BINARY_HOST` (optional mirror for npm fallback downloads)\n- `AGENTATION_CLI_SKIP_DOWNLOAD=1` (skip npm fallback download step)\n\n## npm release workflow\n\nThe npm distribution flow is:\n\n1. `node ./scripts/setPackageVersions.js <version>` syncs the wrapper and platform package versions\n2. `goreleaser` builds GitHub release archives into `dist/`\n3. `node ./scripts/stageNpmPackages.js` extracts the matching binary into each `npm/*` package\n4. publish platform packages first\n5. publish the wrapper package last\n\n## SQLite storage location\n\nBy default, data is stored in SQLite at:\n\n- `$XDG_DATA_HOME/agentation/store.db` (if `XDG_DATA_HOME` is set)\n- otherwise `~/.local/share/agentation/store.db`\n\nYou can override the DB file completely with:\n\n```bash\nAGENTATION_DB_PATH=/absolute/path/store.db agentation start --foreground\n```\n","readmeFilename":"README.md"}