{"_id":"@adhd8k/agent-evolver","_rev":"5-7b6e34e2e4f3dd295a04e849619336bd","name":"@adhd8k/agent-evolver","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@adhd8k/agent-evolver","version":"0.1.0","keywords":["ai","agents","coding","automation","claude","cursor","codex","skills","self-evolving","agentic"],"author":{"name":"adhd8k"},"license":"MIT","_id":"@adhd8k/agent-evolver@0.1.0","maintainers":[{"name":"adhd8k","email":"dev@adhd8k.com"}],"homepage":"https://github.com/adhd8k/agent-evolver#readme","bugs":{"url":"https://github.com/adhd8k/agent-evolver/issues"},"bin":{"agent-evolver":"dist/cli.js"},"dist":{"shasum":"b949b7795cee657ec5d45b5620a5339ea0526607","tarball":"https://registry.npmjs.org/@adhd8k/agent-evolver/-/agent-evolver-0.1.0.tgz","fileCount":45,"integrity":"sha512-ibuZeV7W2SZq156/Z/n7Lg42uJYg7CjntdfmESZNgkdQh9+Vo49UIeXq4280L0eSqXXD09Yeosae2hWBw43zZg==","signatures":[{"sig":"MEUCIQC9Y8M04wGS8yT1ZDE0ZYJhDt59xUBh+NgKcd51z+SxmgIgMiB5MkOJ/t7qI7rquGrB0Ys+SQlbNLy4FOu7r4minhs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94261},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"00be26474794d0705751fd1c2884dc3fd8472977","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"jest","build":"tsc","format":"prettier --write 'src/**/*.ts'","prepublishOnly":"npm run build"},"_npmUser":{"name":"adhd8k","email":"dev@adhd8k.com"},"repository":{"url":"git+https://github.com/adhd8k/agent-evolver.git","type":"git"},"_npmVersion":"11.6.2","description":"Self-evolving agentic coding system - agents that learn project patterns and update their own skills","directories":{},"_nodeVersion":"25.2.1","dependencies":{"yaml":"^2.3.4","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.5.0","eslint":"^8.0.0","ts-jest":"^29.1.0","prettier":"^3.0.0","typescript":"^5.3.0","@types/jest":"^29.5.0","@types/node":"^20.11.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-evolver_0.1.0_1771350558867_0.31240871500519773","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@adhd8k/agent-evolver","version":"0.1.6","keywords":["ai","agents","coding","automation","claude","cursor","codex","skills","self-evolving","agentic"],"author":{"name":"adhd8k"},"license":"MIT","_id":"@adhd8k/agent-evolver@0.1.6","maintainers":[{"name":"adhd8k","email":"dev@adhd8k.com"}],"homepage":"https://github.com/adhd8k/agent-evolver#readme","bugs":{"url":"https://github.com/adhd8k/agent-evolver/issues"},"bin":{"agent-evolver":"dist/cli.js"},"dist":{"shasum":"20051384c4f9fb3cbf7f79a5e1babbc3d4459c7f","tarball":"https://registry.npmjs.org/@adhd8k/agent-evolver/-/agent-evolver-0.1.6.tgz","fileCount":48,"integrity":"sha512-le6zxQtyVnAeP+jfteoQ6sTKhsMh3O3MQDfqrPqTB1+R8VYkXrSNMF/ZpVY4AqIAsxhoOS4yV3nAtD8v9KH6Gw==","signatures":[{"sig":"MEUCIQDVUzFlpSH0h1E+ON21L1Qx8ZUjGL+gUJwLp/zLgVl5gwIgVlSWjGcWD7EYIHR7YjN3Y4LAfO9UZ6Pl1HEnU2DlK+Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@adhd8k%2fagent-evolver@0.1.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":87060},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"6e4f5fbc04c212d2a469521c62493e4b991d1d7b","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"jest","build":"tsc","format":"prettier --write 'src/**/*.ts'","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:71fc764e-5c86-4224-98c1-8c316c219980"}},"repository":{"url":"git+https://github.com/adhd8k/agent-evolver.git","type":"git"},"_npmVersion":"11.6.2","description":"Self-evolving agentic coding system - agents that learn project patterns and update their own skills","directories":{},"_nodeVersion":"24.13.0","dependencies":{"yaml":"^2.3.4","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.5.0","eslint":"^8.0.0","ts-jest":"^29.1.0","prettier":"^3.0.0","typescript":"^5.3.0","@types/jest":"^29.5.0","@types/node":"^20.11.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-evolver_0.1.6_1771360653515_0.317150019549278","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@adhd8k/agent-evolver","version":"0.1.7","keywords":["ai","agents","coding","automation","claude","cursor","codex","skills","self-evolving","agentic"],"author":{"name":"adhd8k"},"license":"MIT","_id":"@adhd8k/agent-evolver@0.1.7","maintainers":[{"name":"adhd8k","email":"dev@adhd8k.com"}],"homepage":"https://github.com/adhd8k/agent-evolver#readme","bugs":{"url":"https://github.com/adhd8k/agent-evolver/issues"},"bin":{"agent-evolver":"dist/cli.js"},"dist":{"shasum":"268340ae56f8c15b074adae67f167be8aff39ea6","tarball":"https://registry.npmjs.org/@adhd8k/agent-evolver/-/agent-evolver-0.1.7.tgz","fileCount":48,"integrity":"sha512-55s3+3jc6O/bq4zJpno5/f1VVhOHpYlHg3rUkDsvqXpAKc2zaX78oi6AUETiTsi8mNZbq6+maVZOXRkpxXmFww==","signatures":[{"sig":"MEYCIQCYvHaPUCYpU9sU9hQ8fc9WwKF+voG35XLwjImjSlgPrgIhAL377hvr1wNF9nn0MdbmbDzl2kXtBD/9hVXEU1BwKrPA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@adhd8k%2fagent-evolver@0.1.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":88557},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"d3a6a208332a794fb3813223164dae966daf43dd","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"jest","build":"tsc","format":"prettier --write 'src/**/*.ts'","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:71fc764e-5c86-4224-98c1-8c316c219980"}},"repository":{"url":"git+https://github.com/adhd8k/agent-evolver.git","type":"git"},"_npmVersion":"11.6.2","description":"Self-evolving agentic coding system - agents that learn project patterns and update their own skills","directories":{},"_nodeVersion":"24.13.0","dependencies":{"yaml":"^2.3.4","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.5.0","eslint":"^8.0.0","ts-jest":"^29.1.0","prettier":"^3.0.0","typescript":"^5.3.0","@types/jest":"^29.5.0","@types/node":"^20.11.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-evolver_0.1.7_1771360812420_0.10751811842516057","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@adhd8k/agent-evolver","version":"0.2.0","keywords":["ai","agents","coding","automation","claude","cursor","codex","skills","self-evolving","agentic"],"author":{"name":"adhd8k"},"license":"MIT","_id":"@adhd8k/agent-evolver@0.2.0","maintainers":[{"name":"adhd8k","email":"dev@adhd8k.com"}],"homepage":"https://github.com/adhd8k/agent-evolver#readme","bugs":{"url":"https://github.com/adhd8k/agent-evolver/issues"},"bin":{"agent-evolver":"dist/cli.js"},"dist":{"shasum":"53f5c1a788339ff51bfcb2503ad11628b632f946","tarball":"https://registry.npmjs.org/@adhd8k/agent-evolver/-/agent-evolver-0.2.0.tgz","fileCount":51,"integrity":"sha512-UuYvBprnZi803BSRWnjgE+xTsc+MCdw29j54iwCVJX5PCr6wtn9nhYbHq7WXOXy5jbf4BObrD8vt8GUx8QK1jg==","signatures":[{"sig":"MEYCIQD6sBAQPYJKEpJ/S3C/xPrKgl9CpXDh6fFSTViJts6lKAIhAMGTck7NVPqK4Mckie9rzQqT7F3dHlz66LabxIl+eEOl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@adhd8k%2fagent-evolver@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":96559},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"913a7f3385c810326d39ecf310a33dfd35ed6e5c","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"jest","build":"tsc","format":"prettier --write 'src/**/*.ts'","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:71fc764e-5c86-4224-98c1-8c316c219980"}},"repository":{"url":"git+https://github.com/adhd8k/agent-evolver.git","type":"git"},"_npmVersion":"11.6.2","description":"Self-evolving agentic coding system - agents that learn project patterns and update their own skills","directories":{},"_nodeVersion":"24.13.0","dependencies":{"yaml":"^2.3.4","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.5.0","eslint":"^8.0.0","ts-jest":"^29.1.0","prettier":"^3.0.0","typescript":"^5.3.0","@types/jest":"^29.5.0","@types/node":"^20.11.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-evolver_0.2.0_1771619231465_0.17619157254878393","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@adhd8k/agent-evolver","version":"0.2.2","description":"Self-evolving agentic coding system - agents that learn project patterns and update their own skills","main":"dist/index.js","bin":{"agent-evolver":"dist/cli.js"},"engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","dev":"tsc --watch","prepublishOnly":"npm run build","test":"jest","lint":"eslint src --ext .ts","format":"prettier --write 'src/**/*.ts'"},"keywords":["ai","agents","coding","automation","claude","cursor","codex","skills","self-evolving","agentic"],"author":{"name":"adhd8k"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/adhd8k/agent-evolver.git"},"homepage":"https://github.com/adhd8k/agent-evolver#readme","bugs":{"url":"https://github.com/adhd8k/agent-evolver/issues"},"devDependencies":{"@types/node":"^20.11.0","@types/jest":"^29.5.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","eslint":"^8.0.0","jest":"^29.5.0","prettier":"^3.0.0","ts-jest":"^29.1.0","typescript":"^5.3.0"},"dependencies":{"commander":"^11.1.0","yaml":"^2.3.4"},"gitHead":"81ce17c12ae586b9ad27ed36f6e4804f1bc91b1a","types":"./dist/index.d.ts","_id":"@adhd8k/agent-evolver@0.2.2","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-qTUfku45Q99OjhlPAOyRiSzf7SiqS6kcr3r+pDKgfIReiSmP7wfdNkjGg3F6Irwpk5icz7fvmqyIyNhYvU56qQ==","shasum":"966973e8645ce2d0d7324c5ee0451b7c59fda3be","tarball":"https://registry.npmjs.org/@adhd8k/agent-evolver/-/agent-evolver-0.2.2.tgz","fileCount":58,"unpackedSize":107932,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@adhd8k%2fagent-evolver@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDtbv/78lJ2/LSIGqzc6jmAuEuTTYRYNzuZcELwoUG9jAIhAL2KCRdgPnbY0dv3Ed2XmAK8kciTYbenE2cyOYRYXrVd"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:71fc764e-5c86-4224-98c1-8c316c219980"}},"directories":{},"maintainers":[{"name":"adhd8k","email":"dev@adhd8k.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-evolver_0.2.2_1772734007224_0.2391181742437225"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-17T17:49:18.780Z","modified":"2026-03-05T18:06:47.738Z","0.1.0":"2026-02-17T17:49:19.034Z","0.1.6":"2026-02-17T20:37:33.659Z","0.1.7":"2026-02-17T20:40:12.563Z","0.2.0":"2026-02-20T20:27:11.597Z","0.2.2":"2026-03-05T18:06:47.475Z"},"bugs":{"url":"https://github.com/adhd8k/agent-evolver/issues"},"author":{"name":"adhd8k"},"license":"MIT","homepage":"https://github.com/adhd8k/agent-evolver#readme","keywords":["ai","agents","coding","automation","claude","cursor","codex","skills","self-evolving","agentic"],"repository":{"type":"git","url":"git+https://github.com/adhd8k/agent-evolver.git"},"description":"Self-evolving agentic coding system - agents that learn project patterns and update their own skills","maintainers":[{"name":"adhd8k","email":"dev@adhd8k.com"}],"readme":"# Agent Evolver\n\n**Give your AI coding agent a memory. Teach it your project's patterns as you build.**\n\n[![npm version](https://img.shields.io/npm/v/@adhd8k/agent-evolver)](https://www.npmjs.com/package/@adhd8k/agent-evolver)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n---\n\nAI agents start every session knowing nothing about your project. Agent Evolver gives them skills that learn from your work — recording decisions, extracting patterns, and evolving over time.\n\n## Quick Start\n\n```bash\n# Run without installing\nnpx @adhd8k/agent-evolver install\n\n# Or install globally\nnpm install -g @adhd8k/agent-evolver\nagent-evolver install\n```\n\nThat's it. Agent Evolver detects your coding agent (Claude Code, Cursor, Aider) and installs the skills locally into your project.\n\n---\n\n## What Gets Installed\n\nFive skills your agent can use automatically:\n\n| Skill | What it does |\n|-------|-------------|\n| `consult-knowledge` | Looks up past decisions and patterns before acting |\n| `record-architectural-decision` | Captures why you made a decision, not just what you decided |\n| `extract-pattern` | Recognizes when something has been done 3+ times and codifies it |\n| `update-skill` | Lets the agent improve its own instructions based on what it learns |\n| `autonomy-preferences` | Learns when to ask you vs. decide autonomously |\n\nSkills are installed locally to your project (`.claude/skills/` for Claude Code) and tracked in git — so your whole team benefits.\n\n---\n\n## Autonomy Preferences\n\nTired of your agent asking permission for everything? Or worried it's making decisions without you?\n\nThe `autonomy-preferences` skill lets you configure how autonomous your agent should be. On first use, it asks:\n\n> **How autonomous should I be when making decisions?**\n> - **Ask me first** — I want to approve architectural, design, and technical decisions\n> - **Suggest then proceed** — Show me what you're thinking, but don't wait for approval\n> - **Fully autonomous** — Make reasonable decisions, I'll correct you if needed\n> - **Let me customize** — Set different levels per category\n\n### Decision Categories\n\n| Category | Examples |\n|----------|----------|\n| **Architectural** | Database schema, service boundaries, API architecture |\n| **Design** | API design, type definitions, module organization |\n| **Technical** | Framework selection, algorithms, performance trade-offs |\n| **UI/UX** | Layout, styling, interactions, accessibility |\n| **Process** | Branching strategy, commit conventions, release decisions |\n\n### Modes\n\n| Mode | Behavior |\n|------|----------|\n| `ask` | Agent asks for approval before proceeding |\n| `suggest-then-proceed` | Agent states its decision and continues without waiting |\n| `autonomous` | Agent decides without asking; you correct if needed |\n\nPreferences are stored in `.agent-evolver/autonomy-preferences.yaml` and persist across sessions.\n\n---\n\n## CLI Commands\n\n```bash\n# Install all skills (auto-detects your agent)\nagent-evolver install\n\n# Install a specific skill\nagent-evolver install -s record-architectural-decision\n\n# Install globally to your agent's home directory\nagent-evolver install --global\n\n# Force a specific agent\nagent-evolver install -a claude-code\n\n# See what's available\nagent-evolver list\n\n# Check which agents are detected\nagent-evolver detect\n```\n\n---\n\n## Local vs Global\n\n**Local (default, recommended)**\nSkills live in `./.claude/skills/` — version controlled, project-specific, shareable with your team.\n\n**Global** (`--global`)\nSkills live in `~/.claude/skills/` — available everywhere, but not tied to any project.\n\n---\n\n## Supported Agents\n\n- **Claude Code** (claude)\n- **Cursor** (planned)\n- **Aider** (planned)\n\n---\n\n## Contributing\n\n```bash\ngit clone https://github.com/adhd8k/agent-evolver.git\ncd agent-evolver\nnpm install\nnpm run build\nnpm test\n```\n\nPRs welcome. See [open issues](https://github.com/adhd8k/agent-evolver/issues).\n\n---\n\nMIT License\n","readmeFilename":"README.md"}