CLI commands

The rulepack CLI runs with no install via npx rulepack <command>, or install it globally. It speaks both English and 日本語 — it picks your locale on first run.

add

Install a pack into the current project. Downloads, verifies the SHA-256, and writes the memory files.

rulepack add @ichi/nextjs
rulepack add nextjs                 # house packs install by bare name
rulepack add @ichi/pack --force     # overwrite existing files without prompting

update

Update installed packs to newer registry versions. By default it picks the highest version that satisfies the declared dependency range; --latest goes to the newest available. Verifies the SHA-256 and confirms before overwriting local files (--force skips the per-file prompts).

rulepack update                     # all installed packs
rulepack update @ichi/nextjs        # a single pack
rulepack update --latest            # ignore declared ranges

init

Scaffold a rulepack.json in the current directory. Discovers existing memory files and asks which ones to include.

rulepack init

link

Scan the current project for existing Markdown memory files and link them into rulepack.json. Conventional paths (CLAUDE.md, AGENTS.md, .cursor/rules/…) are classified as standard memories; any other Markdown is offered as a custom memory with an editable key.

rulepack link

memory add

Add a single memory to rulepack.json — a standard agent key, or a custom memory with optional description, readWhen, priority, and tags.

rulepack memory add

publish

Pack the declared files and publish to the registry. Requires login and a claimed scope. Versions are immutable.

rulepack publish

login

Authenticate with the registry. Opens a browser to approve the CLI session; the token is stored at ~/.rulepackrc (chmod 0600). For CI, set RULEPACK_TOKEN instead.

rulepack login

search

Search packs on the registry by name, scope, or keyword.

rulepack search nextjs

whoami

Show the currently logged-in user and the active registry.

rulepack whoami

logout

Remove the locally stored credentials.

rulepack logout