Claude Code

Connect Claude Code to your Neuronz.ai account. New to Neuronz.ai? Start with Connect your agent for what you get and how the pieces fit; this page is the step-by-step setup.

Prerequisites

• A Neuronz.ai account with a verified email address — see Create your account.
• Claude Code installed locally.
• Python 3 on your PATH — the plugin's hooks use only the standard library. On Windows, install Git for Windows (its Git Bash runs the hooks) or use WSL, then install Python 3. If no interpreter is found, Claude Code shows a visible hook error rather than silently disabling memory.

1. Install the plugin

Add the Neuronz.ai plugin marketplace and install the plugin:

claude plugin marketplace add \
  https://github.com/neuronzai/neuronzai.git
claude plugin install neuronzai@neuronzai

The address in the first command is the official Neuronz.ai plugin repository. If the command includes --sparse, Claude Code downloads only the plugin's own folders from it instead of the whole repository. The install uses Claude Code's default user scope, so the plugin is available in every project; there is no scope flag to pass. You can perform the same steps from /plugin.

2. Sign in from Claude Code

Start a new session, then run:

/neuronzai:login

The plugin opens Neuronz.ai in your browser, signs you in there, and stores the login in your system keychain where one is available. The plugin's tools and its automatic steps share that login, including after Claude Code restarts. You do not need to export a URL or token, paste a credential into the conversation, or register the MCP server separately.

To disconnect this machine later, run /neuronzai:logout. See Authentication & API keys for storage details and the non-interactive API-key fallback.

Signing in on a machine with no browser

On a headless machine — a server you reach over SSH, or a container — there is no browser to open, so /neuronzai:login finishes in two steps instead of one.

Run it as usual. Rather than failing, it prints a sign-in link and tells you it could not find a browser. Open that link on any device that can reach Neuronz.ai, approve the sign-in, and the page hands you a short code. Paste that code back into the session, and the login completes.

You end up with exactly the same login a desktop sign-in produces, so everything afterwards behaves identically. The link is good for about ten minutes; if it lapses, just run /neuronzai:login again.

The code is safe to paste: it can only be used once, and it is bound to the machine that started the sign-in by a secret that never leaves it, so it is useless to anyone else.

3. See it work

Start a new session. If it opens with ⚠ Neuronz.ai is not signed in, run /neuronzai:login again; otherwise you are connected. Running /mcp also lists the Neuronz.ai server as connected.

From then on, on every prompt the agent is told how many of your stored records match and reads the ones it needs. A new account starts empty, so nothing is matched yet. Ask the agent to remember a fact ("remember that retries are capped at 3 with exponential backoff and jitter"), then ask about it in a new session. The agent should find and use that fact.

To give a new profile a head start, have the agent read the repository you are in (or the repositories, GitHub, Notion and docs you name) and store what it learns:

/neuronzai:init-profile

See Filling a profile.

If you add or change a skill or command stored in Neuronz.ai, re-sync it into this session without restarting:

/neuronzai:reload-assets

Claude Code re-scans skills straight away; commands and subagents it read at startup need a new session, and the command says which of the two you are looking at.

Staying up to date

Per-marketplace auto-update is off by default for third-party marketplaces. Run /plugin, open Marketplaces, select neuronzai, and choose Enable auto-update. Claude Code then refreshes it at startup, and every new session loads the latest hooks and workflows.

A running session keeps the version it started with. /reload-plugins refreshes skills and MCP servers in place, but commands and hooks take effect in a new session. The plugin displays a one-line reminder when the installed version is newer than the running one.

Turn auto-update on from settings.json

You can also enable it in Claude Code's settings.json:

"extraKnownMarketplaces": {
  "neuronzai": {
    "source": { "source": "git", "url": "https://github.com/neuronzai/neuronzai.git" },
    "autoUpdate": true
  }
}

For manual updates, run claude plugin update neuronzai and start a new session, or use /plugin marketplace update neuronzai.

Uninstalling

Run /neuronzai:logout first to remove this machine's login, then:

claude plugin uninstall neuronzai@neuronzai

Next

• Core concepts — memory, knowledge, topics, and the graph.
• All features — every capability.
• MCP tools — the full tool surface.