{"_id":"@daominhhiep/codex-kit","_rev":"6-ce7f9468fc48fddab27496dc33db3c3b","name":"@daominhhiep/codex-kit","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@daominhhiep/codex-kit","version":"0.1.0","keywords":["codex","openai","skills","agents","workflows","cli"],"license":"MIT","_id":"@daominhhiep/codex-kit@0.1.0","maintainers":[{"name":"daominhhiep","email":"daominhhiep97@gmail.com"}],"homepage":"https://github.com/daominhhiep/codex-kit#readme","bugs":{"url":"https://github.com/daominhhiep/codex-kit/issues"},"bin":{"codex-kit":"bin/codex-kit.js"},"dist":{"shasum":"233824f9481e50b3ca07450f46ff621f3cef26e2","tarball":"https://registry.npmjs.org/@daominhhiep/codex-kit/-/codex-kit-0.1.0.tgz","fileCount":236,"integrity":"sha512-s672qyt4F01SzKxFNYEu4JaDGtvcHcfidCuSoD4AwwDl5id8ysZUmk7r4Vz1hhXR7dQZmuWvivNBtiZxf7O5VQ==","signatures":[{"sig":"MEYCIQC/y19pqnTwawY4wVt9C3dr/CIbbuUVi2xFdYIaDkzRRwIhANba0/2CB2TV0IBailmQsV9yjQIBG7BoSbAuKSKp4s34","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1376660},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"902e8cfc241b9f0112fc65141567a3def14957d7","scripts":{"test":"node --test"},"_npmUser":{"name":"daominhhiep","email":"daominhhiep97@gmail.com"},"repository":{"url":"git+https://github.com/daominhhiep/codex-kit.git","type":"git"},"_npmVersion":"10.9.4","description":"Codex-native starter kit with reusable skills, subagents, workflows, and a project scaffold CLI.","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/codex-kit_0.1.0_1775050091739_0.16080001805847122","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@daominhhiep/codex-kit","version":"0.1.1","keywords":["codex","openai","skills","agents","workflows","cli"],"license":"MIT","_id":"@daominhhiep/codex-kit@0.1.1","maintainers":[{"name":"daominhhiep","email":"daominhhiep97@gmail.com"}],"homepage":"https://github.com/daominhhiep/codex-kit#readme","bugs":{"url":"https://github.com/daominhhiep/codex-kit/issues"},"bin":{"codex-kit":"bin/codex-kit.js"},"dist":{"shasum":"1e4c81a41e2b4080d90fd14f4440ce34c2d50ebc","tarball":"https://registry.npmjs.org/@daominhhiep/codex-kit/-/codex-kit-0.1.1.tgz","fileCount":236,"integrity":"sha512-EO25yLgla+UB+YdXTIucGmziwHm+0f1WvyAwUKBVaSM7osRsEVIRDFWfBZC7FdL+NvwL65bFF1ZWqHYbEkQbcw==","signatures":[{"sig":"MEUCIQCkvRYxKsE7/X7pSAChJn0ldpf4FgU54ZHPaDdaJi8USQIgLHKntlBfsWQkYV9AeS0HNHrPPwi9l0W24myz9pYHSZE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1376978},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"11ba364cc4a7c29844b42702441bdaaa60c74408","scripts":{"test":"node --test"},"_npmUser":{"name":"daominhhiep","email":"daominhhiep97@gmail.com"},"repository":{"url":"git+https://github.com/daominhhiep/codex-kit.git","type":"git"},"_npmVersion":"10.8.2","description":"Codex kit with reusable skills, subagents, workflows, and a project scaffold CLI.","directories":{},"_nodeVersion":"20.20.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/codex-kit_0.1.1_1775052460487_0.6542817176535265","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@daominhhiep/codex-kit","version":"0.1.2","keywords":["codex","openai","skills","agents","workflows","cli"],"license":"MIT","_id":"@daominhhiep/codex-kit@0.1.2","maintainers":[{"name":"daominhhiep","email":"daominhhiep97@gmail.com"}],"homepage":"https://github.com/daominhhiep/codex-kit#readme","bugs":{"url":"https://github.com/daominhhiep/codex-kit/issues"},"bin":{"codex-kit":"bin/codex-kit.js"},"dist":{"shasum":"3c296687f12f87fab18ad99a9ee2685cd9658f2c","tarball":"https://registry.npmjs.org/@daominhhiep/codex-kit/-/codex-kit-0.1.2.tgz","fileCount":240,"integrity":"sha512-ALHXgd62ydBX9UtcqvE+VdjaBKhJQtyyjyXcoNnrNVfUiWR51IpkzEW53vx55YZbZQMxKVu0vA/icQ+uzGJ7Vg==","signatures":[{"sig":"MEYCIQDZ+9M5buBhuXZoC6YTNMQVyRcONAqk4CgVzU1JiRZvdgIhAKLe2m6RfnOk786u0AO8nYFvmfThz5A7w+STEXPSfWMp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1406195},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"11082cb25e5dfeda0087b6a93481c90ce7c58123","scripts":{"test":"node --test"},"_npmUser":{"name":"daominhhiep","email":"daominhhiep97@gmail.com"},"repository":{"url":"git+https://github.com/daominhhiep/codex-kit.git","type":"git"},"_npmVersion":"11.9.0","description":"Codex kit with reusable skills, subagents, workflows, and a project scaffold CLI.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/codex-kit_0.1.2_1775065982998_0.8553449201396788","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@daominhhiep/codex-kit","version":"0.1.3","keywords":["codex","openai","skills","agents","workflows","cli"],"license":"MIT","_id":"@daominhhiep/codex-kit@0.1.3","maintainers":[{"name":"daominhhiep","email":"daominhhiep97@gmail.com"}],"homepage":"https://github.com/daominhhiep/codex-kit#readme","bugs":{"url":"https://github.com/daominhhiep/codex-kit/issues"},"bin":{"codex-kit":"bin/codex-kit.js"},"dist":{"shasum":"e459fa4351d830ebc3295e37c883df90cbb0da59","tarball":"https://registry.npmjs.org/@daominhhiep/codex-kit/-/codex-kit-0.1.3.tgz","fileCount":241,"integrity":"sha512-6q6hs/bWjb01Hyc7y7sf25SPbj4/XYrmzUiKSCXybeyPH33leUwzpWL6v7qcl76NErpmLdACBJFnpefuqXV6MA==","signatures":[{"sig":"MEQCIEfKOSr/90OwNdf6A+Gg4MllgZWJScrdUwKhcijeL4EEAiBQ2MUBaqwk9yjRRps77Cp3qyALOTcrgm+0DAkmYAZ02Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1418178},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"5923b490f6a536ed4c25a906bdc961ea5430a103","scripts":{"test":"node --test"},"_npmUser":{"name":"daominhhiep","email":"daominhhiep97@gmail.com"},"repository":{"url":"git+https://github.com/daominhhiep/codex-kit.git","type":"git"},"_npmVersion":"11.9.0","description":"Codex kit with reusable skills, subagents, workflows, and a project scaffold CLI.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/codex-kit_0.1.3_1775070298671_0.9662715274240354","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@daominhhiep/codex-kit","version":"0.1.4","keywords":["codex","openai","skills","agents","workflows","cli"],"license":"MIT","_id":"@daominhhiep/codex-kit@0.1.4","maintainers":[{"name":"daominhhiep","email":"daominhhiep97@gmail.com"}],"homepage":"https://github.com/daominhhiep/codex-kit#readme","bugs":{"url":"https://github.com/daominhhiep/codex-kit/issues"},"bin":{"codex-kit":"bin/codex-kit.js"},"dist":{"shasum":"e2cccc70bbf45241c1b74ea8bc88a39da7c688b8","tarball":"https://registry.npmjs.org/@daominhhiep/codex-kit/-/codex-kit-0.1.4.tgz","fileCount":244,"integrity":"sha512-kbmTKqhkRx08Jf1CFVgtlyvoMwJe1iYutGmhGgkztireme78ezdiu1gak7fh6D68GPrvLnOpaSpJ5fKg6J7sLA==","signatures":[{"sig":"MEUCIQDZxekAYVh4UPsXdfSE02Nq1d8WBjoHqXurdYzqpmyzHgIgF0o/bhWR1hm7U9J7GAVHv9lOZBjRBtZog1hQCUvFK8Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1452444},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"44e5845d25cbcc92b7b3caebe9f60c4319d11f78","scripts":{"test":"node --test"},"_npmUser":{"name":"daominhhiep","email":"daominhhiep97@gmail.com"},"repository":{"url":"git+https://github.com/daominhhiep/codex-kit.git","type":"git"},"_npmVersion":"11.9.0","description":"Codex kit with reusable skills, subagents, workflows, and a project scaffold CLI.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/codex-kit_0.1.4_1775108085656_0.6176032919038139","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@daominhhiep/codex-kit","version":"0.2.0","description":"Codex kit with reusable skills, subagents, workflows, and a project scaffold CLI.","type":"module","bin":{"codex-kit":"bin/codex-kit.js"},"engines":{"node":">=20.0.0"},"scripts":{"test":"node --test"},"keywords":["codex","openai","skills","agents","workflows","cli"],"repository":{"type":"git","url":"git+https://github.com/daominhhiep/codex-kit.git"},"homepage":"https://github.com/daominhhiep/codex-kit#readme","bugs":{"url":"https://github.com/daominhhiep/codex-kit/issues"},"license":"MIT","gitHead":"4b9a40b1b333d323afb8ffabcbd9af29f8b3aef0","_id":"@daominhhiep/codex-kit@0.2.0","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-SNbByl+/w72s58J+tcZYjNi1x0v6uCHRdz5c6W3xM9gcx9fy0qV5h/EZkcfBvdRhFGsJ0dZeB5wj1qiOulHhnQ==","shasum":"b3a2f0b622add43533547752faac2c515c33c4d3","tarball":"https://registry.npmjs.org/@daominhhiep/codex-kit/-/codex-kit-0.2.0.tgz","fileCount":247,"unpackedSize":1488722,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCKN2lDQlwS1ZxUHcrHHz8iV9pxbqimMcREUlJDtxkCeAIhAMsW1779J9jTfUL0ko5yQcPRa1ZgAUDikpxpPG96KglG"}]},"_npmUser":{"name":"daominhhiep","email":"daominhhiep97@gmail.com"},"directories":{},"maintainers":[{"name":"daominhhiep","email":"daominhhiep97@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/codex-kit_0.2.0_1778498648914_0.23170917379997213"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T13:28:11.605Z","modified":"2026-05-11T11:24:09.265Z","0.1.0":"2026-04-01T13:28:11.921Z","0.1.1":"2026-04-01T14:07:40.750Z","0.1.2":"2026-04-01T17:53:03.201Z","0.1.3":"2026-04-01T19:04:58.915Z","0.1.4":"2026-04-02T05:34:45.851Z","0.2.0":"2026-05-11T11:24:09.136Z"},"bugs":{"url":"https://github.com/daominhhiep/codex-kit/issues"},"license":"MIT","homepage":"https://github.com/daominhhiep/codex-kit#readme","keywords":["codex","openai","skills","agents","workflows","cli"],"repository":{"type":"git","url":"git+https://github.com/daominhhiep/codex-kit.git"},"description":"Codex kit with reusable skills, subagents, workflows, and a project scaffold CLI.","maintainers":[{"name":"daominhhiep","email":"daominhhiep97@gmail.com"}],"readme":"# Codex Kit\n\n[](https://www.npmjs.com/package/@daominhhiep/codex-kit)\n[](https://opensource.org/licenses/MIT)\n\n> Codex-native starter kit with scaffolded docs, skills, workflows, agents, plugin support, and local skill management.\n\n**[Official Website](https://codexkit.xyz/)** | **[Web Docs](https://codexkit.xyz/#/docs/introduction)**\n\n![\"Codex](\"https://unikorn.vn/api/widgets/badge/codex-kit?theme=dark\")
\n\nCodex Kit helps you bootstrap a repository that already knows how to work with Codex.\n\nInstead of rebuilding the same operating layer in every project, you get a ready-to-use scaffold with routing docs, a shipped skill catalog, workflow playbooks, focused subagents, Codex config, and update/status commands.\n\n## Quick Install\n\n```bash\nnpx @daominhhiep/codex-kit init\n```\n\nOr install globally:\n\n```bash\nnpm install -g @daominhhiep/codex-kit\ncodex-kit init\n```\n\nInitialize into a specific directory:\n\n```bash\nnpx @daominhhiep/codex-kit init --path ./my-project\n```\n\n## What You Get\n\n- root routing docs: `AGENTS.md`, `ARCHITECTURE.md`, `AGENT_FLOW.md`\n- 40+ shipped skills in `.agents/skills`\n- 16 workflow playbooks in `.agents/workflows`\n- 16 focused subagents in `.codex/agents`\n- shared UI/UX data and scripts in `.agents/.shared`\n- project-scoped Codex config in `.codex/config.toml`\n- optional Codex execution rules in `codex/rules/default.rules`\n- managed-file tracking in `.codex-kit/manifest.json`\n\n## CLI\n\nPrimary commands:\n\n```bash\ncodex-kit init\ncodex-kit install\ncodex-kit install --target plugin\ncodex-kit install --target mcp\ncodex-kit install --target skills\ncodex-kit install --target skills --scope local\ncodex-kit update\ncodex-kit sync --target mcp\ncodex-kit sync --target plugin\ncodex-kit sync --target skills\ncodex-kit sync --target skills --scope local\ncodex-kit list --target skills\ncodex-kit list --target skills --query frontend\ncodex-kit list --target skills --scope local\ncodex-kit list --target plugin\ncodex-kit list --target mcp\ncodex-kit remove --target skills --scope local --skills clean-code,planning\ncodex-kit autoskills\ncodex-kit autoskills --scope local\ncodex-kit autoskills --dry-run\ncodex-kit setup-codex\ncodex-kit sync-codex\ncodex-kit status\n```\n\nCommon examples:\n\n```bash\ncodex-kit init --path ./my-project\ncodex-kit install --path ./my-project\ncodex-kit install --target plugin\ncodex-kit install --target mcp\ncodex-kit install --target skills\n\ncodex-kit list --target skills\ncodex-kit list --target skills --query frontend\ncodex-kit list --target skills --scope local\ncodex-kit list --target mcp\n\ncodex-kit install --target skills --scope local\ncodex-kit install --target skills --scope local --skills clean-code,planning\ncodex-kit sync --target skills --scope local --skills clean-code,planning\ncodex-kit remove --target skills --scope local --skills clean-code,planning\n\ncodex-kit setup-codex\ncodex-kit sync-codex\n```\n\nLegacy aliases still work:\n\n```bash\ncodex-kit install --target project\ncodex-kit sync --target project\ncodex-kit list-skills\ncodex-kit search-skills frontend\ncodex-kit list-installed-skills\ncodex-kit install-skills\ncodex-kit sync-skills\ncodex-kit remove-skills --skills clean-code,planning\n```\n\n## Codex Integration\n\nCodex Kit ships with a local Codex plugin scaffold:\n\n- plugin manifest: `plugins/codex-kit/.codex-plugin/plugin.json`\n- plugin skill: `plugins/codex-kit/skills/codex-kit/SKILL.md`\n- local marketplace support via `.agents/plugins/marketplace.json`\n\nThere are two different installation scopes:\n\n- project-local: `init` or plain `install` installs the scaffold, while `install --target plugin` or `install --target skills` add only those parts into the current repository\n- project-local MCP: `install --target mcp` writes the shipped MCP bundle into `.codex/config.toml`\n- user-local: the shipped skill catalog is installed into `${CODEX_HOME:-~/.codex}/skills`\n- user-local MCP: `install --target mcp --scope local` writes the shipped MCP bundle into `${CODEX_HOME:-~/.codex}/config.toml`\n\nTo scaffold a project:\n\n```bash\nnpx @daominhhiep/codex-kit init\nnpx @daominhhiep/codex-kit install\n```\n\nTo install only the workspace plugin into the current project:\n\n```bash\nnpx @daominhhiep/codex-kit install --target plugin\n```\n\nTo install only the shipped project skills into the current project:\n\n```bash\nnpx @daominhhiep/codex-kit install --target skills\n```\n\nTo install the shipped MCP bundle into the project or local Codex config:\n\n```bash\nnpx @daominhhiep/codex-kit install --target mcp\nnpx @daominhhiep/codex-kit install --target mcp --scope local\n```\n\nThe shipped MCP bundle currently includes:\n\n- `context7` for developer documentation\n- a commented `mysql` example via `@benborla29/mcp-server-mysql`; uncomment it only when you want to enable MySQL MCP intentionally\n\nTo do the full local setup in one go for the current repository:\n\n```bash\nnpx @daominhhiep/codex-kit setup-codex\n```\n\nAfter upgrading Codex Kit, sync both the workspace plugin and local shipped skills:\n\n```bash\nnpx @daominhhiep/codex-kit sync-codex\n```\n\nTo install the shipped skills into local Codex:\n\n```bash\nnpx @daominhhiep/codex-kit install --target skills --scope local\n```\n\nBy default, local skills are installed into:\n\n```text\n${CODEX_HOME:-~/.codex}/skills\n```\n\n## Autoskills\n\nInspired by [midudev/autoskills](https://github.com/midudev/autoskills), Codex Kit ships its own auto-detection command. Instead of pulling from third-party registries, it scans the project stack and installs only the relevant skills from Codex Kit's audited catalog.\n\n```bash\nnpx @daominhhiep/codex-kit autoskills\nnpx @daominhhiep/codex-kit autoskills --scope local\nnpx @daominhhiep/codex-kit autoskills --dry-run\n```\n\nThe scanner inspects `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `Gemfile`, framework config files (Next.js, Tailwind, Playwright, Vitest, ...) and file extensions (`.sh`, `.ps1`, `.tsx`, ...). It also recognizes cross-stack combos such as `React + Tailwind CSS`, `Next.js + Playwright`, or `FastAPI + SQLAlchemy`, and adds a small \"frontend bonus\" (design + SEO) when a web frontend is detected.\n\nProject-scope installs land in `.agents/skills//` next to the rest of the Codex Kit scaffold, and write a digest of the run to `.codex-kit/autoskills-lock.json`. Local-scope installs land in `${CODEX_HOME:-~/.codex}/skills`. Pass `--force` to overwrite existing files; the default behavior is non-destructive.\n\nTo browse or search the shipped catalog:\n\n```bash\nnpx @daominhhiep/codex-kit list --target skills\nnpx @daominhhiep/codex-kit list --target skills --query frontend\nnpx @daominhhiep/codex-kit list --target skills --scope local\n```\n\nThe bundled plugin can also help map natural requests such as \"cài skill frontend\" or \"liệt kê skills debug\" to the right Codex Kit commands.\n\n## Codex Rules\n\nCodex Kit now ships a minimal execution policy template at `codex/rules/default.rules`.\n\nIt is intentionally narrow:\n\n- prompts before dependency installs such as `npm install` or `pnpm install`\n- prompts before `git push`\n- prompts before Codex Kit writes into local Codex with `--scope local`\n\nIt does not replace `AGENTS.md`, skills, or workflows. Those files still handle behavior and routing; `codex/rules/default.rules` is only for sandbox approval policy.\n\n## Requirements\n\n- Node.js `>=20`\n\n## Documentation\n\n- [Introduction](https://codexkit.xyz/#/docs/introduction)\n- [Installation](https://codexkit.xyz/#/docs/installation)\n- [Local Codex Setup](https://codexkit.xyz/#/docs/local-codex-setup)\n- [CLI Reference](https://codexkit.xyz/#/docs/commands-and-options)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}