Installation

The CLI ships as a single npm package, @neuralconfig/nrepo, and installs one binary: nrepo.

Requirements

• Node.js 18 or later (the package declares engines.node as >=18)
• npm (included with Node.js)

Install

1. Install the package globally:

   npm install -g @neuralconfig/nrepo

2. Confirm the binary is on your PATH:

   nrepo --version
   # 0.0.9

3. Authenticate:

   nrepo login

Until you have logged in once, nrepo --help ends with a short getting-started box. It disappears as soon as ~/.config/neuralrepo/config.json exists — the CLI prints it there because npm suppresses the package’s own post-install message on most systems.

Update

npm install -g @neuralconfig/nrepo@latest

npm update -g @neuralconfig/nrepo also works. Nothing in the CLI updates itself — the version check below only tells you that an update exists.

The version check

Every invocation runs a non-blocking version check:

Behaviour	Detail
When it runs	Before the command executes, so the notice prints above the command’s own output
Where it prints	stderr, so it never contaminates --json output on stdout
How often it calls npm	At most once a week, cached in ~/.config/neuralrepo/update-check.json
Network timeout	5 seconds, in the background; the command never waits for it
On failure	Silent — a failed check never fails the command
Disable it	Set NREPO_NO_UPDATE_CHECK=1

The notice looks like this:

  nrepo 0.1.0 available (current: 0.0.9). Run npm i -g @neuralconfig/nrepo to update.

Tip

Because the notice goes to stderr, nrepo log --json | jq . is safe as-is. Set NREPO_NO_UPDATE_CHECK=1 in CI anyway, to avoid a weekly outbound call to the npm registry.

The bundled Claude Code skill

The package bundles a Claude Code skill. It is not installed by npm install — you opt in:

/Users/you/.claude/skills/neuralrepo/SKILL.md

nrepo install-skill
# Claude Code skill installed.

If ~/.claude does not exist, the command reports that Claude Code is not installed and exits with status 1 without writing anything.

Two things then happen on their own:

• When the weekly version check finds a newer release, it refreshes that SKILL.md in the background, so the skill stays in step with the CLI between upgrades.
• npm uninstall -g @neuralconfig/nrepo deletes ~/.claude/skills/neuralrepo/ entirely.

Troubleshooting

If nrepo is not found after installing, your npm global bin directory is probably not on your PATH:

npm config get prefix
# Add <prefix>/bin to your PATH
export PATH="$(npm config get prefix)/bin:$PATH"

Next Steps

Authentication What nrepo login actually does, which identity provider it uses, and how to authenticate on a headless machine.

nrepo push Create your first idea from the terminal, with tags and an initial status.

Troubleshooting Which argument is the idea ID, what the error output means, and which commands need Pro.

Claude Code What the bundled skill teaches Claude Code, and the workflow it enables.