{"_id":"@agenaai/cli","_rev":"6-57c64418622037e9a8633f3787abf75e","name":"@agenaai/cli","dist-tags":{"latest":"1.3.1"},"versions":{"1.1.3":{"name":"@agenaai/cli","version":"1.1.3","keywords":["agena","cli","ai-agent","daemon","runtime"],"author":{"name":"AGENA","email":"hello@agena.dev"},"license":"MIT","_id":"@agenaai/cli@1.1.3","maintainers":[{"name":"agenadev","email":"aliozyildirim@gmail.com"}],"homepage":"https://agena.dev","bugs":{"url":"https://github.com/aozyildirim/Agena/issues"},"bin":{"agena":"bin/agena.js"},"dist":{"shasum":"fd285b56c10077c6f57b9e6bd3fe56aa3d83d08d","tarball":"https://registry.npmjs.org/@agenaai/cli/-/cli-1.1.3.tgz","fileCount":19,"integrity":"sha512-XL6rfxdD5Vl0ovMbCRByFLRHesFpZK+/bRaNnlXhN2uI36uA7uynJHS/8gbIclD1rxRu7lbGSm+5+H+rWFfMnA==","signatures":[{"sig":"MEUCIQDY7kfkCA5QNIhbo3SGS+aovq4x1AQSptcWHYqFkLCakQIgLdG9hOntFOvX6TT2geX+A43EHn/HRh9g+iwpFwfMW0w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35083},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"fbe81c91e9d18ff996f7e33349270a090b422800","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenadev","email":"aliozyildirim@gmail.com"},"repository":{"url":"git+https://github.com/aozyildirim/Agena.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.8.2","description":"Official command-line tool for AGENA — enroll your machine as a Runtime, run the CLI bridge, and manage agents.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"keytar":"^7.9.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0"},"optionalDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/cli_1.1.3_1776985315430_0.28204227902714707","host":"s3://npm-registry-packages-npm-production"}},"1.1.4":{"name":"@agenaai/cli","version":"1.1.4","keywords":["agena","cli","ai-agent","daemon","runtime"],"author":{"name":"AGENA","email":"hello@agena.dev"},"license":"MIT","_id":"@agenaai/cli@1.1.4","maintainers":[{"name":"agenadev","email":"aliozyildirim@gmail.com"}],"homepage":"https://agena.dev","bugs":{"url":"https://github.com/aozyildirim/Agena/issues"},"dist":{"shasum":"053d1674be69ecb89bd78615136dd101210f3a88","tarball":"https://registry.npmjs.org/@agenaai/cli/-/cli-1.1.4.tgz","fileCount":19,"integrity":"sha512-aZOAputAyoA+f+PhgrTfTPyhkAJ+HftqNMtgb/ghvcNcSL43yZ0ed1I31jotkVSBrLP4HjpuggQxNIQJ40ZF2Q==","signatures":[{"sig":"MEYCIQDsTjZRjgyUGcDySYBvAy0T9rO4N3OnE9nd6I+AcDuEtQIhALUrFjPTusbao83aBfeyqgKt995hu0domWVYA0i83FQy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35419},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"2b7e738245156f2d5d87eb4059ec10041411699e","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenadev","email":"aliozyildirim@gmail.com"},"repository":{"url":"git+https://github.com/aozyildirim/Agena.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.8.2","description":"Official command-line tool for AGENA — enroll your machine as a Runtime, run the CLI bridge, and manage agents.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"keytar":"^7.9.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0"},"optionalDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/cli_1.1.4_1776985620159_0.5163808456943766","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@agenaai/cli","version":"1.2.0","keywords":["agena","cli","ai-agent","daemon","runtime"],"author":{"name":"AGENA","email":"hello@agena.dev"},"license":"MIT","_id":"@agenaai/cli@1.2.0","maintainers":[{"name":"agenadev","email":"aliozyildirim@gmail.com"}],"homepage":"https://agena.dev","bugs":{"url":"https://github.com/aozyildirim/Agena/issues"},"dist":{"shasum":"37490f4576523fa42538a1f9d33a3e80619cca1f","tarball":"https://registry.npmjs.org/@agenaai/cli/-/cli-1.2.0.tgz","fileCount":30,"integrity":"sha512-5pKYydYnNAsbvHzB9tSFEfrfdm8tQTkOvtqME/W5cRCEcKNKn9xq8/QyLBnJb3yAWzhqANb1PDpY7d39Rg5/OQ==","signatures":[{"sig":"MEUCIQDO+gwOzTabqIUwFtQNL7UQIrWJ5vgJv6cdcXHlUXs3SQIgaB5/nRdIq/bpgaQuFbrd+yOHEM2CCjzCNbp6bcPSP7U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":99809},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"71be565c31daa52e136e05eb744d83d6ce6e43c6","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc","prepack":"mkdir -p bridge && cp ../../docker/bridge-server.mjs bridge/bridge-server.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenadev","email":"aliozyildirim@gmail.com"},"repository":{"url":"git+https://github.com/aozyildirim/Agena.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.8.2","description":"Official command-line tool for AGENA — enroll your machine as a Runtime, run the CLI bridge, and manage tasks, skills, and sprint refinement from the terminal.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"keytar":"^7.9.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0"},"optionalDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/cli_1.2.0_1777007634722_0.7982933542521744","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@agenaai/cli","version":"1.2.1","keywords":["agena","cli","ai-agent","daemon","runtime"],"author":{"name":"AGENA","email":"hello@agena.dev"},"license":"MIT","_id":"@agenaai/cli@1.2.1","maintainers":[{"name":"agenadev","email":"aliozyildirim@gmail.com"}],"homepage":"https://agena.dev","bugs":{"url":"https://github.com/aozyildirim/Agena/issues"},"dist":{"shasum":"71c4f5909aaff3c555c70222429247505956562e","tarball":"https://registry.npmjs.org/@agenaai/cli/-/cli-1.2.1.tgz","fileCount":30,"integrity":"sha512-3bO9zyo5QIRhWOU1JiFgitaSfW+zVO89dg8RiLbKLWndr3YbAQHOll9IazSGvjcO3XKhe2f944m6cQcYQQHetA==","signatures":[{"sig":"MEQCIH8nLVPkjjvjCtVi1/jYzZbUdmfGxavR6UrD9q7TKDPjAiAqpnrZucyqxxNn0ae2SQc49YwPtn0Zu5hGjgrOkhueFQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":99870},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"fc8e09f75044f4544b2f2102dd2cd899c5a146f9","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc","prepack":"mkdir -p bridge && cp ../../docker/bridge-server.mjs bridge/bridge-server.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenadev","email":"aliozyildirim@gmail.com"},"repository":{"url":"git+https://github.com/aozyildirim/Agena.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.8.2","description":"Official command-line tool for AGENA — enroll your machine as a Runtime, run the CLI bridge, and manage tasks, skills, and sprint refinement from the terminal.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"keytar":"^7.9.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0"},"optionalDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/cli_1.2.1_1777008391137_0.8746040291246164","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@agenaai/cli","version":"1.3.0","keywords":["agena","cli","ai-agent","daemon","runtime"],"author":{"name":"AGENA","email":"hello@agena.dev"},"license":"MIT","_id":"@agenaai/cli@1.3.0","maintainers":[{"name":"agenadev","email":"aliozyildirim@gmail.com"}],"homepage":"https://agena.dev","bugs":{"url":"https://github.com/aozyildirim/Agena/issues"},"dist":{"shasum":"852575e73ea1562b351c66786f29b0b613be8f88","tarball":"https://registry.npmjs.org/@agenaai/cli/-/cli-1.3.0.tgz","fileCount":30,"integrity":"sha512-YQiunJNTN2h07S0qMnPutwgo8a1vx9n60+39LBnuA6yC0Kbxa9KTum8xVVmzIzuuBL2C67MS64Db3EBY3Q6wDQ==","signatures":[{"sig":"MEUCIQCTIzT5gzHzn1OdIEy846DB6FUsY35HpM752S+FAxxrGAIgUZXBiqZ24en6cmoOaXpTingbSUXDOnv82QUhUnZaOYk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102292},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"39ff0b1ec188db5df4228f875bd81ac85acb44e7","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc","prepack":"mkdir -p bridge && cp ../../docker/bridge-server.mjs bridge/bridge-server.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"agenadev","email":"aliozyildirim@gmail.com"},"repository":{"url":"git+https://github.com/aozyildirim/Agena.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.8.2","description":"Official command-line tool for AGENA — enroll your machine as a Runtime, run the CLI bridge, and manage tasks, skills, and sprint refinement from the terminal.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"keytar":"^7.9.0","commander":"^12.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.10.0"},"optionalDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/cli_1.3.0_1777411097788_0.21699205187244686","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@agenaai/cli","version":"1.3.1","description":"Official command-line tool for AGENA — enroll your machine as a Runtime, run the CLI bridge, and manage tasks, skills, and sprint refinement from the terminal.","main":"dist/index.js","scripts":{"build":"tsc","dev":"ts-node --esm src/index.ts","prepack":"mkdir -p bridge && cp ../../docker/bridge-server.mjs bridge/bridge-server.mjs","prepublishOnly":"npm run build"},"keywords":["agena","cli","ai-agent","daemon","runtime"],"author":{"name":"AGENA","email":"hello@agena.dev"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aozyildirim/Agena.git","directory":"packages/cli"},"homepage":"https://agena.dev","engines":{"node":">=18"},"dependencies":{"commander":"^12.1.0","keytar":"^7.9.0"},"optionalDependencies":{},"devDependencies":{"@types/node":"^22.10.0","typescript":"^5.7.0"},"_id":"@agenaai/cli@1.3.1","gitHead":"f5c2c1d22616427125a236f0392d0952bb456d59","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/aozyildirim/Agena/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-WNXHNV6K/VHsPmc6mkuW8qoH2dsZH1tt4/oPAfDqY1LK7YZIDDN/IlW0/RdlUKRZYZ3Z8IFm0VOSebCYgCFEFQ==","shasum":"bb1a672943011108c703173081f64f08660c8564","tarball":"https://registry.npmjs.org/@agenaai/cli/-/cli-1.3.1.tgz","fileCount":30,"unpackedSize":102292,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHHVt436NjD5c1BN36ZR+N8ix7eJaMITpj2lJ9VOoI6KAiEA6uIFdlrvd+VVEuYxrbBYMqVWb1dgf+AB8Uno7x1c7pQ="}]},"_npmUser":{"name":"agenadev","email":"aliozyildirim@gmail.com"},"directories":{},"maintainers":[{"name":"agenadev","email":"aliozyildirim@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_1.3.1_1777411378936_0.35172711609623386"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-23T23:01:55.319Z","modified":"2026-04-28T21:22:59.224Z","1.1.3":"2026-04-23T23:01:55.558Z","1.1.4":"2026-04-23T23:07:00.373Z","1.2.0":"2026-04-24T05:13:54.914Z","1.2.1":"2026-04-24T05:26:31.280Z","1.3.0":"2026-04-28T21:18:17.929Z","1.3.1":"2026-04-28T21:22:59.080Z"},"bugs":{"url":"https://github.com/aozyildirim/Agena/issues"},"author":{"name":"AGENA","email":"hello@agena.dev"},"license":"MIT","homepage":"https://agena.dev","keywords":["agena","cli","ai-agent","daemon","runtime"],"repository":{"type":"git","url":"git+https://github.com/aozyildirim/Agena.git","directory":"packages/cli"},"description":"Official command-line tool for AGENA — enroll your machine as a Runtime, run the CLI bridge, and manage tasks, skills, and sprint refinement from the terminal.","maintainers":[{"name":"agenadev","email":"aliozyildirim@gmail.com"}],"readme":"# @agenaai/cli\n\nOfficial command-line tool for AGENA — enroll your machine as a\nRuntime, manage the CLI bridge daemon, and drive the whole platform\n(tasks, skills, sprint refinement) from the terminal.\n\n## Install\n\n```bash\n# Homebrew (macOS / Linux) — recommended\nbrew install aozyildirim/tap/agena\n\n# npm (any platform)\nnpm install -g @agenaai/cli\n\n# one-shot\nnpx @agenaai/cli --help\n```\n\n## First-run setup\n\n```bash\nagena setup\n```\n\nWalks you through:\n\n1. **Pick a backend + tenant** (defaults to `https://api.agena.dev`).\n2. **Browser-based OAuth** via RFC 8628 device-code flow — no token\n   copy-paste. (Falls back to manual JWT paste for CI / headless\n   shells; the key in DevTools is `localStorage.agena_token`.)\n3. **Starts the bridge daemon**, which auto-enrolls this machine as\n   a Runtime.\n\nConfig lives in `~/.agena/config.json`; the JWT is stored in the OS\nkeychain (macOS Keychain / libsecret / Windows Credential Manager)\nwhen available, falling back to the config file.\n\n## Commands\n\n### Auth & tenant\n\n```\nagena login                    Device-code OAuth (or --jwt to paste manually)\nagena setup                    Login + daemon start in one shot\nagena whoami                   Current user, tenant, JWT source\nagena org list                 Organizations you belong to\nagena org switch <slug>        Switch the active tenant for this CLI\n```\n\n### Daemon (local CLI bridge)\n\nThe bridge is the process Agena's backend calls into to drive Claude\nCode / Codex on your machine. Starting the daemon also enrolls this\nhost in the Runtimes registry.\n\n```\nagena daemon start             Spawn the bridge, auto-enroll\nagena daemon stop              Kill the running daemon\nagena daemon status            Is it running?\nagena daemon logs -n 100       Tail the daemon log\n```\n\n### Runtimes\n\n```\nagena runtime list             Every runtime on the tenant + status\nagena runtime status <id>      Detail view for one runtime\n```\n\n### Tasks\n\n```\nagena task list                Recent tasks (filter: -s running, etc.)\nagena task show <id>           Full task detail\nagena task logs <id>           Tail the task's log trail\nagena task create -t \"Fix bug\" --assign\n                               Create a task and immediately enqueue\n                               it for the AI agent\n```\n\n### Skill catalog\n\nSkills are reusable patterns the platform auto-extracts from\ncompleted tasks — they get prepended to agent system prompts when a\nnew task matches.\n\n```\nagena skill list               Browse the catalog\nagena skill list -q auth       Search by name/tag/description\nagena skill show <id>          Full skill incl. prompt fragment\nagena skill search \"fix 502\"   Vector-search the catalog\nagena skill delete <id> -y     Remove a skill\n```\n\n### Sprint refinement (history-grounded story points)\n\nQdrant-backed retrieval over the team's completed work items —\ngrounds LLM estimates in the project's real history.\n\n```\nagena refinement backfill -p MyProject -t MyTeam --days 730\n                               Kick off the Azure/Jira → Qdrant import\nagena refinement backfill-status\n                               Poll the indexer\nagena refinement history       List what's currently indexed\nagena refinement history --sp 5 -q \"auth\"\n                               Filter by SP / keyword\nagena refinement analyze -p MyProject -t MyTeam --sprint-path '...'\n                               Estimate SP for an upcoming sprint\n```\n\nAll commands read `~/.agena/config.json`. `agena login` is\nidempotent — re-run it to rotate JWT or switch tenant.\n\n## How it talks to the backend\n\nEvery command hits the same REST API the dashboard uses\n(`/tasks`, `/skills`, `/runtimes`, `/refinement/*`, `/auth/me`,\n`/auth/device/*`). The CLI is a thin client — no business logic\nlives here. See `packages/sdk/` for a reusable TypeScript client.\n\n## Bundled bridge\n\n`agena daemon start` looks for `bridge-server.mjs` in this order:\n\n1. Bundled inside the npm package (`<install-dir>/bridge/`)\n2. Monorepo checkout (`../../docker/bridge-server.mjs`)\n3. `~/.agena/bridge-server.mjs`\n4. `./docker/bridge-server.mjs` in the current working directory\n\nThe npm package ships the bridge so `npm install -g @agenaai/cli`\nis self-contained.\n","readmeFilename":"README.md"}