{"_id":"@artsnlabs/dotagents","_rev":"6-c8393448e9fc971d4bbd3045b9c6898b","name":"@artsnlabs/dotagents","dist-tags":{"latest":"0.5.0"},"versions":{"0.1.0":{"name":"@artsnlabs/dotagents","version":"0.1.0","keywords":["cli","agents","prompts","skills","assets","sync"],"author":{"url":"https://moee.dev","name":"Moe Haje","email":"hello@moee.dev"},"license":"MIT","_id":"@artsnlabs/dotagents@0.1.0","maintainers":[{"name":"moehaje","email":"hello@moee.dev"}],"homepage":"https://github.com/moehaje/dotagents#readme","bugs":{"url":"https://github.com/moehaje/dotagents/issues"},"bin":{"dotagents":"dist/index.js"},"dist":{"shasum":"d139591b815bb8cf544d3482fc7c5a18895b9f8e","tarball":"https://registry.npmjs.org/@artsnlabs/dotagents/-/dotagents-0.1.0.tgz","fileCount":48,"integrity":"sha512-pVtBaF+LCj38pE0VyDVnBRbJ/Kix9FyEC0Aec3X0j71/E043RLGLzWDQ2Bj36rXuFigh/yOuho3a0je/ezRG7A==","signatures":[{"sig":"MEYCIQDxGp/+UOkb9dBf/TDbAEQFN4XX+GguJ7k++LY0FHVzVQIhAPTsWIZalB68xWAjck12ZMlbf7SxXcP5ifASP3kpaU8d","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":167309},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"34eeb96fcc35b7f3f637e211a606e37ba9239332","scripts":{"dev":"tsx src/index.ts","lint":"biome lint .","test":"vitest run","build":"npm run clean && npm run generate-licenses && tsc -p tsconfig.json && node scripts/ensure-shebang.js","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","format":"biome format --write .","prepack":"npm run build","prepare":"husky","type-check":"tsc -p tsconfig.json --noEmit","format:check":"biome format .","generate-licenses":"node scripts/generate-licenses.js"},"_npmUser":{"name":"moehaje","email":"hello@moee.dev"},"repository":{"url":"git+https://github.com/moehaje/dotagents.git","type":"git"},"_npmVersion":"11.8.0","description":"CLI for managing agents assets from a canonical dotagents repo.","directories":{},"lint-staged":{"*.{ts,tsx,js,mjs,cjs,json,yml,yaml,md}":["biome check --write --no-errors-on-unmatched"]},"_nodeVersion":"22.19.0","dependencies":{"picocolors":"^1.1.1","@clack/prompts":"^0.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","husky":"^9.1.7","vitest":"^4.0.4","typescript":"^5.8.2","@types/node":"^22.13.4","lint-staged":"^16.2.7","@biomejs/biome":"^2.3.13","license-checker":"^25.0.1"},"_npmOperationalInternal":{"tmp":"tmp/dotagents_0.1.0_1770330243935_0.383911962779399","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@artsnlabs/dotagents","version":"0.2.0","keywords":["cli","agents","prompts","skills","assets","sync"],"author":{"url":"https://moee.dev","name":"Moe Haje","email":"hello@moee.dev"},"license":"MIT","_id":"@artsnlabs/dotagents@0.2.0","maintainers":[{"name":"moehaje","email":"hello@moee.dev"}],"homepage":"https://github.com/moehaje/dotagents#readme","bugs":{"url":"https://github.com/moehaje/dotagents/issues"},"bin":{"dotagents":"dist/index.js"},"dist":{"shasum":"ba1d7b77f71275b5a3179c873bb9323cb33e072c","tarball":"https://registry.npmjs.org/@artsnlabs/dotagents/-/dotagents-0.2.0.tgz","fileCount":48,"integrity":"sha512-ZHcIQrGP9LrrdzkTfjFRInUw6GsjbkVZdfUkcFcnGGsYi+dF1hjMFqqM81znMyiNw++kd7vPbEwDcCGUcE8A1Q==","signatures":[{"sig":"MEUCIEf5tVSkFyk90q9GnmlwUZBQTHLEoTWngpBtEjn4O+VxAiEA0F7XStGDjLJViqJQAOWg59IE8yim5BAqiSYALTALoAc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":168278},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"7894d0f97b84afab9728a0b392190d2f9073d146","scripts":{"dev":"tsx src/index.ts","lint":"biome lint .","test":"vitest run","build":"npm run clean && npm run generate-licenses && tsc -p tsconfig.json && tsx scripts/ensure-shebang.ts","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","format":"biome format --write .","prepack":"npm run build","prepare":"husky","type-check":"tsc -p tsconfig.json --noEmit","format:check":"biome format .","generate-licenses":"tsx scripts/generate-licenses.ts","release:homebrew-metadata":"tsx scripts/homebrew-metadata.ts --formula"},"_npmUser":{"name":"moehaje","email":"hello@moee.dev"},"repository":{"url":"git+https://github.com/moehaje/dotagents.git","type":"git"},"_npmVersion":"10.8.2","description":"CLI for managing agents assets from a canonical dotagents repo.","directories":{},"lint-staged":{"*.{ts,tsx,js,mjs,cjs,json,yml,yaml,md}":["biome check --write --no-errors-on-unmatched"]},"_nodeVersion":"20.20.0","dependencies":{"picocolors":"^1.1.1","@clack/prompts":"^0.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","husky":"^9.1.7","vitest":"^4.0.4","typescript":"^5.8.2","@types/node":"^22.13.4","lint-staged":"^16.2.7","@biomejs/biome":"^2.3.13","license-checker":"^25.0.1"},"_npmOperationalInternal":{"tmp":"tmp/dotagents_0.2.0_1770332209657_0.5893183471894619","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@artsnlabs/dotagents","version":"0.3.0","keywords":["cli","agents","prompts","skills","assets","sync"],"author":{"url":"https://moee.dev","name":"Moe Haje","email":"hello@moee.dev"},"license":"MIT","_id":"@artsnlabs/dotagents@0.3.0","maintainers":[{"name":"moehaje","email":"hello@moee.dev"}],"homepage":"https://github.com/moehaje/dotagents#readme","bugs":{"url":"https://github.com/moehaje/dotagents/issues"},"bin":{"dotagents":"dist/index.js"},"dist":{"shasum":"67a7e713b297176711d0fc7694b74d1cad89ec79","tarball":"https://registry.npmjs.org/@artsnlabs/dotagents/-/dotagents-0.3.0.tgz","fileCount":48,"integrity":"sha512-LLLOMxprOgz4ldO5e1MvYI/sxZwZimkxBetPK2totr/zu5NeqmsiJAGCE+aF75NWJHmKfd5jRYgSOy6ZQm7RXQ==","signatures":[{"sig":"MEQCIG+/dOD4eBBWatflqzQ3vaZdxvSdcTpAdo8yGyUpjP63AiAGE+H1URlNGbCgjH8c/yCmoGJ7C++MPPWXl6j1rhQXjQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":200313},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"f4a29bd7bd02557037a3925a8fb2f1918d1ad72a","scripts":{"dev":"tsx src/index.ts","lint":"biome lint .","test":"vitest run","build":"npm run clean && npm run generate-licenses && tsc -p tsconfig.json && tsx scripts/ensure-shebang.ts","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","format":"biome format --write .","prepack":"npm run build","prepare":"husky","type-check":"tsc -p tsconfig.json --noEmit","format:check":"biome format .","generate-licenses":"tsx scripts/generate-licenses.ts","release:homebrew-metadata":"tsx scripts/homebrew-metadata.ts --formula"},"_npmUser":{"name":"moehaje","email":"hello@moee.dev"},"repository":{"url":"git+https://github.com/moehaje/dotagents.git","type":"git"},"_npmVersion":"10.8.2","description":"Unified CLI for managing agent assets (prompts, skills, configs) from one home source across projects, local agents, and sync workflows.","directories":{},"lint-staged":{"*.{ts,tsx,js,mjs,cjs,json,yml,yaml,md}":["biome check --write --no-errors-on-unmatched"]},"_nodeVersion":"20.20.0","dependencies":{"picocolors":"^1.1.1","@clack/prompts":"^0.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","husky":"^9.1.7","vitest":"^4.0.4","typescript":"^5.8.2","@types/node":"^22.13.4","lint-staged":"^16.2.7","@biomejs/biome":"^2.3.13","license-checker":"^25.0.1"},"_npmOperationalInternal":{"tmp":"tmp/dotagents_0.3.0_1770420809158_0.5218506524102775","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@artsnlabs/dotagents","version":"0.3.1","keywords":["cli","agents","prompts","skills","assets","sync"],"author":{"url":"https://moee.dev","name":"Moe Haje","email":"hello@moee.dev"},"license":"MIT","_id":"@artsnlabs/dotagents@0.3.1","maintainers":[{"name":"moehaje","email":"hello@moee.dev"}],"homepage":"https://github.com/moehaje/dotagents#readme","bugs":{"url":"https://github.com/moehaje/dotagents/issues"},"bin":{"dotagents":"dist/index.js"},"dist":{"shasum":"568967d683270d62b0d45da134fbcaebdfaa4266","tarball":"https://registry.npmjs.org/@artsnlabs/dotagents/-/dotagents-0.3.1.tgz","fileCount":48,"integrity":"sha512-bsXVwrdLMn2zCU2kV4E9wkGNHAX8tcQSpygMbzbdIs60ZiAV8HGSy35NVVw8UhqwHC11n/G/7T11BvKiuXq6Eg==","signatures":[{"sig":"MEYCIQDsHcNpXhAu95PfO+wE1gvjAla26S0QvRlmWigLzcim2wIhAO59c80Ov3s2dUIcnnmR3j22ZDHcAYrCHaTBWml3Dkgy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":199918},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"14f6500097a4f5cd24f2c23b74bd6df5a9ecd03f","scripts":{"dev":"tsx src/index.ts","lint":"biome lint .","test":"vitest run","build":"npm run clean && npm run generate-licenses && tsc -p tsconfig.json && tsx scripts/ensure-shebang.ts","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","format":"biome format --write .","prepack":"npm run build","prepare":"husky","type-check":"tsc -p tsconfig.json --noEmit","format:check":"biome format .","generate-licenses":"tsx scripts/generate-licenses.ts","release:homebrew-metadata":"tsx scripts/homebrew-metadata.ts --formula"},"_npmUser":{"name":"moehaje","email":"hello@moee.dev"},"repository":{"url":"git+https://github.com/moehaje/dotagents.git","type":"git"},"_npmVersion":"10.8.2","description":"Unified CLI for managing agent assets (prompts, skills, configs) from one home source across projects, local agents, and sync workflows.","directories":{},"lint-staged":{"*.{ts,tsx,js,mjs,cjs,json,yml,yaml,md}":["biome check --write --no-errors-on-unmatched"]},"_nodeVersion":"20.20.0","dependencies":{"picocolors":"^1.1.1","@clack/prompts":"^0.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","husky":"^9.1.7","vitest":"^4.0.4","typescript":"^5.8.2","@types/node":"^22.13.4","lint-staged":"^16.2.7","@biomejs/biome":"^2.3.13","license-checker":"^25.0.1"},"_npmOperationalInternal":{"tmp":"tmp/dotagents_0.3.1_1770421595603_0.754908530525856","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@artsnlabs/dotagents","version":"0.4.0","keywords":["cli","agents","prompts","skills","assets","sync"],"author":{"url":"https://moee.dev","name":"Moe Haje","email":"hello@moee.dev"},"license":"MIT","_id":"@artsnlabs/dotagents@0.4.0","maintainers":[{"name":"moehaje","email":"hello@moee.dev"}],"homepage":"https://github.com/moehaje/dotagents#readme","bugs":{"url":"https://github.com/moehaje/dotagents/issues"},"bin":{"dotagents":"dist/index.js"},"dist":{"shasum":"87b44cc0cce226cf1eb5a129f5f2e14af9c9bd5e","tarball":"https://registry.npmjs.org/@artsnlabs/dotagents/-/dotagents-0.4.0.tgz","fileCount":57,"integrity":"sha512-swtepxJYyp3bPSJ65wtlOjdXmo3WS1S2tLtSFoGUtKe8MUJLkSVoe/1LFyPcqd77graAMVeHXc7QNcgFlOjFiw==","signatures":[{"sig":"MEUCIE3loke5knl5q+NC742vnkYfanSlpyX3B92gyn8y4rSfAiEA+pxwuQdD8iBZMHl1DTzNqJf3sFPkg7uHjRfhQ1voEbM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":304530},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"f04ee95e53cea8988b5fdbbe848aaa733d4c2cc6","scripts":{"dev":"tsx src/index.ts","lint":"biome lint .","test":"vitest run","build":"npm run clean && npm run generate-licenses && tsc -p tsconfig.json && tsx scripts/ensure-shebang.ts","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","format":"biome format --write .","prepack":"npm run build","prepare":"husky","type-check":"tsc -p tsconfig.json --noEmit","format:check":"biome format .","generate-licenses":"tsx scripts/generate-licenses.ts","release:homebrew-metadata":"tsx scripts/homebrew-metadata.ts --formula"},"_npmUser":{"name":"moehaje","email":"hello@moee.dev"},"repository":{"url":"git+https://github.com/moehaje/dotagents.git","type":"git"},"_npmVersion":"10.8.2","description":"Unified CLI for managing agent assets (prompts, skills, configs) from one home source across projects, local agents, and sync workflows.","directories":{},"lint-staged":{"*.{ts,tsx,js,mjs,cjs,json,yml,yaml,md}":["biome check --write --no-errors-on-unmatched"]},"_nodeVersion":"20.20.0","dependencies":{"picocolors":"^1.1.1","@clack/prompts":"^0.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","husky":"^9.1.7","vitest":"^4.0.4","typescript":"^5.8.2","@types/node":"^22.13.4","lint-staged":"^16.2.7","@biomejs/biome":"^2.3.13","license-checker":"^25.0.1"},"_npmOperationalInternal":{"tmp":"tmp/dotagents_0.4.0_1770765374609_0.12153345452915443","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@artsnlabs/dotagents","version":"0.5.0","description":"Unified CLI for managing agent assets (prompts, skills, configs) from one home source across projects, local agents, and sync workflows.","license":"MIT","author":{"name":"Moe Haje","email":"hello@moee.dev","url":"https://moee.dev"},"repository":{"type":"git","url":"git+https://github.com/moehaje/dotagents.git"},"bugs":{"url":"https://github.com/moehaje/dotagents/issues"},"homepage":"https://github.com/moehaje/dotagents#readme","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"engines":{"node":">=18"},"keywords":["cli","agents","prompts","skills","assets","sync","agent-skills","ai-agents"],"bin":{"dotagents":"dist/index.js"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"scripts":{"clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","generate-licenses":"tsx scripts/generate-licenses.ts","build":"npm run clean && npm run generate-licenses && tsc -p tsconfig.json && tsx scripts/ensure-shebang.ts","dev":"tsx src/index.ts","format":"biome format --write .","format:check":"biome format .","lint":"biome lint .","prepare":"husky","prepack":"npm run build","release:homebrew-metadata":"tsx scripts/homebrew-metadata.ts --formula","test":"vitest run","type-check":"tsc -p tsconfig.json --noEmit"},"lint-staged":{"*.{ts,tsx,js,mjs,cjs,json,yml,yaml,md}":["biome check --write --no-errors-on-unmatched"]},"dependencies":{"@clack/prompts":"^0.11.0","picocolors":"^1.1.1"},"devDependencies":{"@biomejs/biome":"^2.3.13","@types/node":"^22.13.4","husky":"^9.1.7","license-checker":"^25.0.1","lint-staged":"^16.2.7","tsx":"^4.20.3","typescript":"^5.8.2","vitest":"^4.0.4"},"_id":"@artsnlabs/dotagents@0.5.0","gitHead":"eaeb875de53fb649cdcddf71bee08820cc47855b","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-BeDboXHLN0vUs8TenVtBO5D0C3tvqTYpGjxanYgkgs1Uqell6bL5Au+c6+nm+BnI0ZQXBLfD8UPiRJNOFlJ2Bg==","shasum":"c3319004ad3f131dcacaddda3c296250dfaa0a12","tarball":"https://registry.npmjs.org/@artsnlabs/dotagents/-/dotagents-0.5.0.tgz","fileCount":81,"unpackedSize":461736,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIACrK4vUpsSzGnszY/F7n0RzM5bGMJu8CnUK5dNoq4+5AiEAuv/Qm/kscPsiA0SIdxR/ypDGzhwsv4sUVAIJP757Zes="}]},"_npmUser":{"name":"moehaje","email":"hello@moee.dev"},"directories":{},"maintainers":[{"name":"moehaje","email":"hello@moee.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dotagents_0.5.0_1771285774949_0.5889816774785894"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-05T22:24:03.866Z","modified":"2026-02-16T23:49:35.220Z","0.1.0":"2026-02-05T22:24:04.103Z","0.2.0":"2026-02-05T22:56:49.809Z","0.3.0":"2026-02-06T23:33:29.303Z","0.3.1":"2026-02-06T23:46:35.778Z","0.4.0":"2026-02-10T23:16:14.765Z","0.5.0":"2026-02-16T23:49:35.106Z"},"bugs":{"url":"https://github.com/moehaje/dotagents/issues"},"author":{"name":"Moe Haje","email":"hello@moee.dev","url":"https://moee.dev"},"license":"MIT","homepage":"https://github.com/moehaje/dotagents#readme","keywords":["cli","agents","prompts","skills","assets","sync","agent-skills","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/moehaje/dotagents.git"},"description":"Unified CLI for managing agent assets (prompts, skills, configs) from one home source across projects, local agents, and sync workflows.","maintainers":[{"name":"moehaje","email":"hello@moee.dev"}],"readme":"# dotagents\n\n[![npm version](https://img.shields.io/npm/v/%40artsnlabs%2Fdotagents)](https://www.npmjs.com/package/@artsnlabs/dotagents)\n[![npm downloads](https://img.shields.io/npm/dm/%40artsnlabs%2Fdotagents)](https://www.npmjs.com/package/@artsnlabs/dotagents)\n[![license](https://img.shields.io/npm/l/%40artsnlabs%2Fdotagents)](LICENSE)\n[![CI](https://github.com/moehaje/dotagents/actions/workflows/ci.yml/badge.svg)](https://github.com/moehaje/dotagents/actions/workflows/ci.yml)\n\n`dotagents` is a unified CLI for managing agent assets (prompts, skills, configs) from one home source across projects, local agents, and sync workflows.\n\n## Features\n\n- Create prompts and skills in a tracked home repo.\n- Bootstrap project-local `.agents` directories and starter docs.\n- Optionally install newly created assets to project or configured global agent paths.\n- Add prompts and skills into the current project quickly.\n- Link prompts and skills from home into project/global targets via symlinks.\n- Validate prompt and skill assets before sync/install workflows.\n- Scan agent directories to find unsynced assets.\n- Sync skills using a registry-driven workflow.\n- Delegate skill package operations to the upstream `skills` CLI.\n\n## Requirements\n\n- Node.js 18+\n- npm\n- `npx skills` available for `dotagents skill ...` passthrough and sync flows\n\n## Install\n\n```bash\nnpm i -g @artsnlabs/dotagents\n```\n\nHomebrew (tap):\n\n```bash\nbrew tap moehaje/tap\nbrew install dotagents\n```\n\nHomebrew one-command install:\n\n```bash\nbrew install moehaje/tap/dotagents\n```\n\nWithout global install:\n\n```bash\nnpx @artsnlabs/dotagents --help\n```\n\n## Usage\n\n```bash\ndotagents --help\ndotagents create prompt\ndotagents init -p\ndotagents add prompt release\ndotagents add prompt release --mode symlink\ndotagents link prompt release\ndotagents edit prompt release\ndotagents check --strict\ndotagents add skill terminal-ui\ndotagents scan --sync\ndotagents config\ndotagents skill add vercel-labs/skills@find-skills\ndotagents skill sync --check\ndotagents skill lock\ndotagents skill install\ndotagents skill check-lock\n```\n\n## Command Surface\n\n```bash\ndotagents create [prompt|skill] [name] [--kind <prompt|skill>] [--name <slug>] [--title <title>] [--description <text>] [--args <text>] [--content <text>|--content-file <path>|--content-stdin] [--home <path>] [--project|-p] [--global|-g] [--agent|-a <name>] [--force]\ndotagents init [--project|-p] [--with <prompt:name,skill:name,...>] [--link] [--home <path>] [--force]\ndotagents add [prompt|skill] [name] [--to <path>] [--agent|-a <codex|claude|agents>] [--all|--select <name,...>] [--mode <copy|symlink>] [--home <path>] [--force]\ndotagents link [prompt|skill] [name] [--kind <prompt|skill>] [--name <slug>] [--to <path>] [--agent|-a <codex|claude|agents>] [--all|--select <name,...>] [--home <path>] [--force]\ndotagents edit [prompt|skill] [name] [--kind <prompt|skill>] [--name <slug>] [--file <relative/path>] [--inline] [--editor <cmd>] [--home <path>] [--project|-p] [--global|-g] [--agent|-a <name>]\ndotagents check [prompt|skill] [--home <path>] [--json] [--strict] [--filter <name,...>] [--exclude <name,...>]\ndotagents scan [--home <path>] [--source <path> ...] [--source-only] [--json] [--diff|--diff-full|--explain-conflicts] [--sync|--sync-all|--sync-select <kind:id:path,...>] [--force]\ndotagents config [--home <path> --editor <cmd> --codex <path> --claude <path> --agents <path>]\ndotagents skill <skills-cli-args...>\ndotagents skill sync [--check] [--yes] [--home <path>]\ndotagents skill lock [--manifest <path>] [--lockfile <path>]\ndotagents skill install [--manifest <path>] [--lockfile <path>]\ndotagents skill check-lock [--lockfile <path>]\n```\n\nIf `dotagents add` is run without kind or name in interactive mode, it prompts to select the asset kind and asset(s) from home.\n`dotagents new` is kept as a compatibility alias for `dotagents create`.\nUse `dotagents init` to scaffold `.agents/prompts`, `.agents/skills`, and starter docs in the current project.\nPass `--with prompt:<name>,skill:<name>` to install starter assets during init, and add `--link` to symlink instead of copying.\nUse `dotagents link` for dedicated symlink flows, or `dotagents add --mode symlink` for add-command parity.\nUse create target flags to control where assets are written: `-p` (project), `-g` (global agent homes), `-a codex|claude|agents`.\nCombine `-p` and `-a` to target agent-local project directories (for example `./.codex` or `./.claude`).\n`dotagents edit` uses the same scope flags and defaults to home scope when no target flags are provided.\n`dotagents edit skill` defaults to `SKILL.md`; pass `--file <relative/path>` to edit another file in the skill directory.\nIf `dotagents edit` runs without `<name>` in interactive mode, it shows a picker of assets found in the selected scope.\nUse `--inline` for in-terminal full-content replacement mode (or fallback when no editor can be launched).\nUse `dotagents check` as a quality gate for prompt/skill frontmatter; add `--strict` to fail on warnings, `--json` for CI parsing, `--filter` to check exact asset ids/names, and `--exclude` to skip exact assets.\nUse `dotagents add --all` or `dotagents add --select ...` to avoid interactive pickers when omitting `<name>`.\nUse `dotagents scan --source <path> --source-only` when you need isolated scans without default/global agent directories.\nUse `dotagents scan --diff` or `dotagents scan --diff-full` to review conflict summaries before syncing; add `--explain-conflicts` for explicit reason/recommendation output.\nUse `dotagents scan --sync-all` or `dotagents scan --sync-select ...` for non-interactive sync runs.\nUse `dotagents skill lock` to resolve `agents.toml` into a deterministic `agents.lock.toml`.\nUse `dotagents skill install` to install pinned lockfile skills into project-local `.agents/skills/<id>`.\nUse `dotagents skill check-lock` in CI to verify installed skills match lockfile integrity.\n\n### Skill Manifest and Lock\n\nCreate `agents.toml` in your project root:\n\n```toml\n[project]\nname = \"my-project\"\n\n[[skills]]\nid = \"find-skills\"\nsource = \"vercel-labs/skills@find-skills\"\n```\n\nGenerate lock and install:\n\n```bash\ndotagents skill lock\ndotagents skill install\ndotagents skill check-lock\n```\n\n## Home Repo Resolution\n\n`dotagents` resolves the home repo in this order:\n\n1. `--home <path>`\n2. `DOTAGENTS_HOME`\n3. Global config (`~/.config/dotagents/config.json`, or `$XDG_CONFIG_HOME/dotagents/config.json`)\n4. Filesystem auto-detection for `dotagents` / `dot-agents`\n5. Fallback to `~/dotagents`\n\nOn first run, `dotagents` bootstraps global config and initializes a home layout with:\n- `prompts/`\n- `skills/`\n- `configs/skills-registry.tsv`\n- `scripts/`\n\n## Project Health\n\n- [CI workflow](.github/workflows/ci.yml)\n- [Contributing guide](CONTRIBUTING.md)\n- [Security policy](SECURITY.md)\n- [Code of conduct](CODE_OF_CONDUCT.md)\n- [Changelog](CHANGELOG.md)\n- [Versioning policy](VERSIONING.md)\n- [Third-party notices](ThirdPartyNoticeText.txt)\n\n## Development\n\n```bash\nnpm install\nnpm run format:check\nnpm run lint\nnpm run type-check\nnpm run test\nnpm run build\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}