CLI

The NeuralRepo CLI (nrepo) lets you capture and manage ideas without leaving your terminal. It is fast, scriptable, and works seamlessly with developer workflows — including Claude Code.

Why Use the CLI?

• Fast capture — push an idea in a single command, no context switching
• Scriptable — pipe output, use in shell scripts, integrate with CI/CD
• Works with Claude Code — Claude Code can invoke nrepo commands directly in your development workflow
• JSON output — parse results programmatically for automations

Installation

Install the CLI globally via npm:

npm install -g @neuralconfig/nrepo

Verify the installation:

nrepo --version

Caution

The CLI requires Node.js 18 or later. If you encounter permission errors, see npm’s guide to fixing global install permissions.

Authentication

OAuth (recommended)

Log in using your browser — this is the easiest method:

nrepo login

Your browser opens for authentication. Once approved, credentials are stored in ~/.config/neuralrepo/config.json.

API Key

For headless environments, CI/CD, or scripting, use an API key:

nrepo login --api-key
# Paste your API key when prompted: nrp_your_api_key_here

Generate an API key in Settings > API Keys on the web dashboard. API keys use the format nrp_ followed by 64 hexadecimal characters.

Quick Push

Capture an idea in a single command:

nrepo push "Build a habit tracker app" --body "Mobile-first, with streak tracking and reminders" --tag side-project --status exploring

All flags are optional except the title (the first positional argument):

Flag	Description	Default
--body <text>	Idea body text	(empty)
--tag <tag>	Add a tag (repeatable)	(none)
--status <status>	Set initial status	captured
--json	Force JSON output	(see below)
--human	Force human-readable output	(see below)

Example with multiple tags

nrepo push "AI-powered code review tool" \
  --tag ai \
  --tag devtools \
  --tag saas \
  --status exploring

Output Modes

The CLI supports two output modes:

Mode	When Used	Format
Human-readable	Default when authenticated via OAuth	Formatted text with labels
JSON	Default when authenticated via API key	Machine-parseable JSON

You can override the default with --json or --human on any command:

# Force JSON output (useful for scripting)
nrepo push "My idea" --json

# Force human-readable output (useful with API key auth)
nrepo search "tracker" --human

Human-readable output

Idea created successfully
  ID:     42
  Title:  AI-powered code review tool
  Status: exploring
  Tags:   ai, devtools, saas

JSON output

{
  "id": 42,
  "title": "AI-powered code review tool",
  "status": "exploring",
  "tags": ["ai", "devtools", "saas"],
  "source": "cli",
  "processing": true,
  "created_at": "2026-03-24T10:30:00Z"
}

Tip

The processing: true field indicates that background tasks (embedding generation, duplicate detection) are still running. The idea is saved and available immediately.

Common Commands

# Search ideas
nrepo search "habit tracker"

# List recent ideas
nrepo log

# View a specific idea
nrepo show 42

# Change an idea's status
nrepo move 42 building

# Delete an idea
nrepo rm 42

Configuration

The CLI stores its configuration at:

~/.config/neuralrepo/config.json

This file contains your authentication credentials (OAuth token or API key). Do not share it or commit it to version control.

Full Reference

CLI Command Reference Complete documentation for every nrepo command, flag, and option.