Getting Started

Get Started with NORDON

From install to your first memory in under 5 minutes. Works on macOS, Windows, and Linux.

01

1. Install the CLI

Install NORDON with a single command:

npm install -g @sodasoft/nordon-cli

This installs the nordon CLI and nordond daemon on your machine.

Alternative install methods
# With curl (macOS / Linux)
curl -fsSL https://nordon.io/install.sh | bash

# From source (requires Rust)
cargo install --path crates/nordon-cli
02

2. Create your account

Create a free NORDON account. This lets you manage your plan, sync memories across machines (optional), and get a license key for premium features.

nordon account signup

This opens nordon.io/signup in your browser. Enter your email to create an account. You'll receive a confirmation email.

An account is optional for the free plan. You can skip this step and use NORDON locally without registering. Create an account when you want to upgrade or sync across machines.
03

3. Log in (optional)

If you already have an account, log in to connect your CLI:

nordon account login

Opens the login page in your browser. After logging in, you can check your account status:

nordon account status

# Output:
#   Email:  you@example.com
#   Plan:   FREE
Forgot your password?

Visit nordon.io/login and click "Forgot password". You'll receive a reset link by email.

04

4. Initialize NORDON

Set up your local config and data directories:

nordon init

This creates:

  • Config file: ~/.config/nordon/config.toml
  • Database: ~/.local/share/nordon/nordon.db

Everything stays on your machine. No data is sent anywhere.

05

5. Start the daemon

Start the NORDON daemon in the background:

nordond &

The daemon runs locally on port 7533. It handles event capture, memory storage, scoring, and injection.

Run as a system service (auto-start on login)
# Install as service (works on macOS, Windows, Linux)
nordon service install

# Check service status
nordon service status

# Remove service
nordon service uninstall
06

6. Link your project

Navigate to your project and link it:

cd /path/to/your/project
nordon link-repo

NORDON detects your git remote and generates a unique fingerprint. Free plan supports up to 3 repos.

07

7. Verify setup

nordon doctor

PASS Config file exists

PASS Data directory exists

PASS Database exists

PASS Daemon is running

All checks passed.

08

8. Connect Claude Code

Add NORDON hooks to your Claude Code settings at ~/.claude/settings.json:

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "*",
      "command": "nordon hook post-tool \"$TOOL_NAME\"",
      "timeout": 5000
    }],
    "Stop": [{
      "matcher": "",
      "command": "nordon hook session-end",
      "timeout": 10000
    }]
  }
}

NORDON now captures events from your Claude Code sessions and builds memories automatically.

09

9. Choose your plan

NORDON works on the free plan out of the box. When you need more features, upgrade:

# See your current plan and features
nordon plan show

# Upgrade to Pro or Team (opens pricing page)
nordon plan upgrade

Free

  • 3 repos
  • Basic memory
  • Local only

Pro — $29/mo

  • Unlimited repos
  • Branch-aware
  • Pattern detection
  • Export/import

Team — $79/user/mo

  • Everything in Pro
  • Team sync
  • Shared memory
  • Audit log

After purchasing, you'll receive a license key. Activate it:

# Activate your license
nordon plan activate <your-license-key>

# Verify features are unlocked
nordon plan show

# Check a specific feature
nordon plan check advanced_ranking
Downgrade or cancel
# Revert to free plan
nordon plan deactivate

# Log out completely
nordon account logout

Your memories stay on your machine. Downgrading only limits new features — existing data is never deleted.

You're all set!

NORDON is running. Use your AI coding assistant normally — NORDON works in the background, capturing what matters and bringing it back when you need it.

Quick commands to remember:

nordon status          # Check daemon and stats
nordon memories search # Find stored memories
nordon plan show       # View your plan
nordon logs            # See recent events
nordon dashboard       # Open web dashboard
CLI ReferenceGuidesTroubleshootingHow it works