@codebyplan/claude

CLI that installs CodeByPlan skills, agents, hooks, and rules into a project's local ./.claude/ directory.

Published on npm as @codebyplan/claude; the CLI binary is codebyplan-claude.

Why

CodeByPlan ships its Claude Code assets (skills, agents, hooks, rules) via this standalone npm CLI instead of via Claude Code's plugin/marketplace mechanism. The install model is:

• Local-only: assets are written to the consuming repo's ./.claude/ directory — no global install, no ~/.claude/ writes.
• Manifest-tracked: every installed file is recorded in .claude/.cbp-claude.manifest.json so update and uninstall can act precisely on the files we own. Legacy installs that use the pre-CHK-113 filename (.codebyplan-claude.manifest.json) are auto-migrated on first install or update after upgrade.
• No plugin dependency: works with vanilla Claude Code; no marketplace_* or plugin_* configuration required.

This package replaces the deprecated @codebyplan/claude-plugin Claude Code plugin distribution. The plugin was never published to npm; the GitHub mirror at github.com/midevyou/codebyplan-claude-plugin is archived as part of this release.

Install

npx codebyplan-claude install

This populates ./.claude/skills/, ./.claude/agents/, ./.claude/hooks/, and ./.claude/rules/, and writes a manifest tracking what was installed. The current release installs 39 skills, 11 agents, and a hooks bundle (hooks.json plus shell scripts). The rules/ directory is wired but ships zero rules today — it is created and tracked so future curated rules can land through the same install/update/uninstall flow.

Update

npx codebyplan-claude update

Re-fetches the latest asset versions, replaces tracked files, and refreshes the manifest. Assets you have edited locally are preserved — files whose checksum differs from the originally installed version are left untouched.

Uninstall

npx codebyplan-claude uninstall

Removes every file recorded in the manifest, then removes the manifest itself.

What ships

The install, update, and uninstall verbs are fully implemented. The current 0.1.0 release installs four template categories:

• skills/ — 39 skills covering the full CodeByPlan development workflow
• agents/ — 11 sub-agents (task planner, round executor, testing QA, and others)
• hooks/ — a hooks bundle (hooks.json plus shell scripts) for pre-commit gates, test automation, format-on-edit, and desktop notifications
• rules/ — directory wiring is in place; zero rules are shipped today

Future releases will add curated rules through the same install/update/uninstall flow.

License

MIT