{"_id":"@agnojf/alson","_rev":"7-2c962e8f476028248dc1fb31f0d88cb2","name":"@agnojf/alson","dist-tags":{"latest":"0.5.0"},"versions":{"0.1.0":{"name":"@agnojf/alson","version":"0.1.0","license":"MIT","_id":"@agnojf/alson@0.1.0","maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"bin":{"alson":"bin/alson"},"dist":{"shasum":"750861795fe669c4b1bfdeccbfae0af453666b0c","tarball":"https://registry.npmjs.org/@agnojf/alson/-/alson-0.1.0.tgz","fileCount":38,"integrity":"sha512-/d3Vn0XftRs58jbLAj4ulyUpOoT66XSaNVXXLkggA/OVMCX4W81fgYqR1UvsqwxtyGpZdLdpyczqnHS4SdKyaw==","signatures":[{"sig":"MEQCICRi6TcwmSYBbzK7NELPpcgEFGmVRFe8iqyvBy3ljO7MAiAcMLEZvI5T83B2A0P1VSB/a3GcDx2sM2SmwV1M9d60gw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":82218},"engines":{"node":">=20"},"gitHead":"4e33e722d2408bcaf879c0bf8cba391da452836c","scripts":{"lint":"tsc --noEmit","pack":"npm pack --json","test":"npm run build && node --test \"dist/tests/**/*.test.js\"","build":"tsc && node dist/scripts/generate-catalog.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"agnojf","email":"agnojf@gmail.com"},"_npmVersion":"11.13.0","description":"CLI to search, install, delete, and update agent skills on your machine","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/alson_0.1.0_1786148491147_0.26196593590242423","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agnojf/alson","version":"0.1.1","license":"MIT","_id":"@agnojf/alson@0.1.1","maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"bin":{"alson":"bin/alson"},"dist":{"shasum":"8ca430e43f203112bc0b8b60f7dc0bbb70bca6eb","tarball":"https://registry.npmjs.org/@agnojf/alson/-/alson-0.1.1.tgz","fileCount":38,"integrity":"sha512-H+wFGZZmcyCckk1Kwxs5pyYvHOqyFV63QtJBurqI82bWejZZbPpmDyNVY4261q9C5BUyPhyZaRtV9BuW+r45jg==","signatures":[{"sig":"MEUCIQC8XrVHmyDItFwN1FdsWsR+x5nH0Nuvbd6xumQg4YYElQIgdfR5MfDfsInrrZlmlUG3Z8OP2JP2Q95sqTn15qFZEk0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":84364},"engines":{"node":">=20"},"gitHead":"2fbf12055d967b346786c2fe4cec3284cd6fb25f","scripts":{"lint":"tsc --noEmit","pack":"npm pack --json","test":"npm run build && node --test \"dist/tests/**/*.test.js\"","build":"tsc && node dist/scripts/generate-catalog.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"agnojf","email":"agnojf@gmail.com"},"_npmVersion":"11.13.0","description":"CLI to search, install, delete, and update agent skills on your machine","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/alson_0.1.1_1786150339941_0.32755464458490513","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agnojf/alson","version":"0.2.0","license":"MIT","_id":"@agnojf/alson@0.2.0","maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"bin":{"alson":"bin/alson"},"dist":{"shasum":"93dabbafbd0e5785a9281e83445cf4cc50db5e42","tarball":"https://registry.npmjs.org/@agnojf/alson/-/alson-0.2.0.tgz","fileCount":38,"integrity":"sha512-7jQZgab/gUn2GuGKEXg67sh9ssfnmaEk9ieh9yA2o1NsGLDOC/Qc0Dbl1N1MIgGjqHNU6coVIuhirf94LqELnw==","signatures":[{"sig":"MEUCIQDXGlCVg94NS3wLyx9U/g6gze4tLFi3cxe9ZN6Fk2LjbAIgE9rE5WZ31ynZK5dUxibBw2ec278GUkSkv2oNCfcTFuA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":84766},"engines":{"node":">=20"},"gitHead":"c4c1c931aad003da6f8cc72cb629915d2c704bad","scripts":{"lint":"tsc --noEmit","pack":"npm pack --json","test":"npm run build && node --test \"dist/tests/**/*.test.js\"","build":"tsc && node dist/scripts/generate-catalog.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"agnojf","email":"agnojf@gmail.com"},"_npmVersion":"11.13.0","description":"CLI to search, install, delete, and update agent skills on your machine","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/alson_0.2.0_1786174666474_0.47487440906350953","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agnojf/alson","version":"0.2.1","license":"MIT","_id":"@agnojf/alson@0.2.1","maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"bin":{"alson":"bin/alson"},"dist":{"shasum":"886d7a5089b5c6d38a73b3df96f395eef2e98e7a","tarball":"https://registry.npmjs.org/@agnojf/alson/-/alson-0.2.1.tgz","fileCount":38,"integrity":"sha512-b1wuloDMYS1gfqfuOfdVo6FXFxnNFGRBiXmv73g+gYMiiTq9jMmWIn9Fp3S76KqKxTjZnVzZrPPyUE0s4wJt/g==","signatures":[{"sig":"MEUCIDfWmIvl4YhYt4dvyZcp4OACxe5h0EQaNb93MV6E0eeaAiEA2wg66fbpKDdGtQSxuXNo1vi3MB3fOavg3DYqxeLPhvI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":85269},"engines":{"node":">=20"},"gitHead":"69b0e6653b625d29050e5de8c062714b6f01308b","scripts":{"lint":"tsc --noEmit","pack":"npm pack --json","test":"npm run build && node --test \"dist/tests/**/*.test.js\"","build":"tsc && node dist/scripts/generate-catalog.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"agnojf","email":"agnojf@gmail.com"},"_npmVersion":"11.13.0","description":"CLI to search, install, delete, and update agent skills on your machine","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/alson_0.2.1_1786176475599_0.029919720803149863","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agnojf/alson","version":"0.3.0","license":"MIT","_id":"@agnojf/alson@0.3.0","maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"bin":{"alson":"bin/alson"},"dist":{"shasum":"8ae6562b3fc6db602f0d6c38a9c778c315b4eec7","tarball":"https://registry.npmjs.org/@agnojf/alson/-/alson-0.3.0.tgz","fileCount":56,"integrity":"sha512-dIltc6+HR7qAlblSY92aZvCw368spp9gEHq7g0sKQ1d/IpXZjVYntL7iryb3e6lSgiXbMnKSAaZZEa4oB9PmiQ==","signatures":[{"sig":"MEQCIDfd+sSiq5slPz4ClZiEizfGYMcRRexIhDkNC5nG9b5XAiBdb8r34lA3w4RnAcA+x+9OIDVWIakbtR6CiqGqG6URlA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137570},"engines":{"node":">=20"},"gitHead":"69b0e6653b625d29050e5de8c062714b6f01308b","scripts":{"lint":"tsc --noEmit","pack":"npm pack --json","test":"npm run build && node --test \"dist/tests/**/*.test.js\"","build":"tsc && node dist/scripts/generate-catalog.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"agnojf","email":"agnojf@gmail.com"},"_npmVersion":"11.13.0","description":"CLI to search, install, delete, and update agent skills on your machine","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/alson_0.3.0_1786179587850_0.3336159280803823","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@agnojf/alson","version":"0.4.0","license":"MIT","_id":"@agnojf/alson@0.4.0","maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"bin":{"alson":"bin/alson"},"dist":{"shasum":"3d83b2f07979cb8a2083fe0ecdd41598fc6db2af","tarball":"https://registry.npmjs.org/@agnojf/alson/-/alson-0.4.0.tgz","fileCount":69,"integrity":"sha512-DiAX6YfvoTRBTLwzCwM4eEnsXpFU1yHndqpILmX4AuuPQpdfnxV/FB/JZDbdD/EtJ4yNz8ILt1zj+KTBslH6aQ==","signatures":[{"sig":"MEYCIQCnKUuwpY8MDN6OaP9Db5+tdVx8xmtsU19vpUU6AHLoEQIhANU7+ErXewtwbgm2E8+3iCFIVhtwZVql56DpKRr/OXdJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":166843},"engines":{"node":">=20"},"gitHead":"328c15f901615c4e646f4dcc7264024b06339e5c","scripts":{"lint":"tsc --noEmit","pack":"npm pack --json","test":"npm run build && node --test \"dist/tests/**/*.test.js\"","build":"tsc && node dist/scripts/generate-catalog.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"agnojf","email":"agnojf@gmail.com"},"_npmVersion":"11.13.0","description":"CLI to search, install, delete, and update agent skills on your machine","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/alson_0.4.0_1786180711036_0.09191191370628005","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@agnojf/alson","version":"0.5.0","description":"CLI to search, install, delete, and update agent skills on your machine","license":"MIT","bin":{"alson":"bin/alson"},"engines":{"node":">=20"},"scripts":{"build":"tsc && node dist/scripts/generate-catalog.js","test":"npm run build && node --test \"dist/tests/**/*.test.js\"","lint":"tsc --noEmit","pack":"npm pack --json","prepublishOnly":"npm run build && npm test"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.5.0"},"gitHead":"00c0405264478bd1024ae6dba29f090093acdbee","_id":"@agnojf/alson@0.5.0","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-hZGwRWBzQnpAYuNYqBu4MWdD01I0wHAKVcCmMHZovTxIfycoMloJya+b/vpNWwWeK/XKUAZdirIFD8GMnYyQFQ==","shasum":"d3e75d5bdc8802ec76afa74765e01aba6626f884","tarball":"https://registry.npmjs.org/@agnojf/alson/-/alson-0.5.0.tgz","fileCount":76,"unpackedSize":184356,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBd+q2xcOfQg8TeDg+BPoeCU7od5l8drwZ+uGftHDoakAiA+/jDIqfVxz4w5bTjaqZC2rXwrSOoKVuYbY3uHUZrkvw=="}]},"_npmUser":{"name":"agnojf","email":"agnojf@gmail.com"},"directories":{},"maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/alson_0.5.0_1786234767822_0.7197474295957111"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-08T00:21:30.959Z","modified":"2026-08-09T00:19:28.112Z","0.1.0":"2026-08-08T00:21:31.301Z","0.1.1":"2026-08-08T00:52:20.095Z","0.2.0":"2026-08-08T07:37:46.629Z","0.2.1":"2026-08-08T08:07:55.758Z","0.3.0":"2026-08-08T08:59:47.990Z","0.4.0":"2026-08-08T09:18:31.183Z","0.5.0":"2026-08-09T00:19:27.963Z"},"license":"MIT","description":"CLI to search, install, delete, and update agent skills on your machine","maintainers":[{"name":"agnojf","email":"agnojf@gmail.com"}],"readme":"# Alson\n\nAlson is a thinking partner. It helps people think clearly, decide well, and produce usable outputs. It supports human judgment. It does not replace it.\n\nAlson works by moving from unclear intent to clear action: clarify the real problem, surface assumptions, constraints, and risks, compare options and trade-offs, and turn decisions into practical outputs.\n\nThe `alson` CLI installs Alson's skill sets into your repositories. Skills are focused instruction packages that any compatible agent tool can load. The CLI searches, installs, updates, and deletes those skills.\n\n## Skill Sets\n\nSkills are instruction packages. Each one contains a `SKILL.md` with the skill's behavior and workflow, plus reference files, metadata, and documentation. A skill triggers when a request matches its description.\n\nAll Alson skills share the same operating rules:\n\n- Be direct, calm, neutral, and practical.\n- Lead with the answer, decision point, or next action.\n- Separate facts from assumptions and options from recommendations.\n- State uncertainty clearly. Never fabricate evidence.\n- Support human judgment. Never take ownership of decisions.\n\n### Available Skills\n\n| Skill | Purpose |\n|---|---|\n| `project-intake` | Turns vague or new requests into a structured, audited brief. Asks one question at a time and stops when the request is actionable. Runs a Build, Measure, Learn pipeline. Does not authorize work or make decisions for the requester. |\n| `status-report` | Turns project evidence into an audited project status report. Leads with overall health (RAG) and key metrics. Runs a Build, Measure, Learn pipeline. Every health claim requires evidence; missing evidence means Gray, not Green. Does not reconcile project updates or fabricate evidence. |\n| `closure-report` | Creates or revises a formal Project Closure Report for completed projects or phases. Confirms completion, summarizes results against objectives, documents outstanding items and handoff, and captures lessons learned. Runs an audited Build, Measure, Learn pipeline. Does not authorize closure or produce status reports, lessons-learned registers, or post-implementation reviews. |\n| `alson-explain` | Explains a selected item in context with evidence, citations, and plain-English clarity. Reads only the minimum context needed. Does not summarize, rewrite, research, advise, or make decisions. |\n\nMore skills ship with each release.\n\n## Curated Catalog\n\nAlson maintains the official skill catalog. Skills are reviewed, tested, and bundled into published releases. Users install only the skills included in the version of the CLI they have installed.\n\n## Installation\n\nInstall the CLI globally once:\n\n```bash\nnpm install -g @agnojf/alson@latest\n```\n\nIf npm reports an EACCES permission error, the global npm directory is not writable by your user. Use a user-owned Node installation (for example nvm) or set a user-level npm prefix instead of using sudo:\n\n```bash\nnpm config set prefix \"$HOME/.npm-global\"\necho 'export PATH=\"$HOME/.npm-global/bin:$PATH\"' >> ~/.zshrc\nnpm install -g @agnojf/alson@latest\n```\n\nThe CLI works fully offline after installation.\n\n## Update the CLI\n\nNew skills and fixes ship with new CLI releases. Update to the newest version:\n\n```bash\nnpm install -g @agnojf/alson@latest\nalson --version\n```\n\nThen update your installed skills:\n\n```bash\nalson update --all\n```\n\n## Repository-Local Skills\n\nSkills install into the repository you are working in, not your home directory. From a repository root or any subdirectory:\n\n```bash\ncd my-repo\nalson list\nalson install project-intake\n```\n\nThis creates:\n\n```text\nmy-repo/.agents/skills/project-intake/\nmy-repo/.agents/alson/installed.json\n```\n\n- `.agents/skills/` holds the installed skills.\n- `.agents/alson/installed.json` is Alson's bookkeeping: installed versions, hashes, and timestamps.\n- Each repository has its own install set, isolated from every other repository.\n- The CLI resolves the repository by walking up from the current directory to the nearest `.git` directory. Outside a repository it fails with a clear error.\n\n## Using Installed Skills\n\nAfter installing or updating a skill, start a new session in your agent tool (for example Codex, OpenCode, or Claude Code). Skills are discovered when a session starts. If the skill does not appear, fully restart the agent tool.\n\n## Usage\n\n```text\nalson list                     Show every bundled skill and its status\nalson search [query]           Search bundled skills by name or description\nalson install <skill>          Install a bundled skill\nalson delete <skill>           Remove an installed skill\nalson update [skill]           Update installed skills to the bundled versions\nalson update --all             Update every installed skill\nalson --version                Print the CLI version\n```\n\nExample:\n\n```bash\nalson list\nalson search intake\nalson install project-intake\nalson update --all\nalson delete project-intake\n```\n\n## What the CLI Does Not Do\n\n- It does not execute skills. Skills run inside an agent tool that supports Agent Skills.\n- It does not fetch skills from the network. Skills ship bundled inside the CLI package.\n- It does not install skills into your home directory. Skills are always repository-local.\n\n## Safety\n\n- Installs are atomic: files are staged, verified, then moved into place.\n- The CLI never overwrites or removes a skill it did not install without explicit approval (`--force`).\n- Locally modified skills are detected by hash and protected.\n- Failed updates restore the prior installation.\n\n## Status Values\n\n| Status | Meaning |\n|---|---|\n| not installed | No installation found |\n| current | Installed version matches the bundle |\n| update available | Installed version is older than the bundle |\n| modified | Installed files differ from the recorded hash |\n| unmanaged | The skill exists but was not installed by the CLI |\n| incompatible | Skill requires a newer CLI version |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}