Skip to content
neuralrepo docs neuralrepo docs

Quick Start

Get from zero to capturing ideas in minutes. This guide walks you through signing up, creating your first idea from the web and CLI, and optionally connecting Claude AI.

  1. Sign up at neuralrepo.com

    Head to neuralrepo.com and create your account. You can sign up with:

    • GitHub — recommended for developers
    • Google
    • Magic link — passwordless email login

    No credit card required. Every new account starts with a 30-day Pro trial. The free tier includes 50 ideas and full access to all capture channels.

  2. Create your first idea from the web dashboard

    Once signed in, click the New Idea button in the top right. Fill in:

    • Title — a short, descriptive name for your idea
    • Body — optional details in Markdown
    • Tags — categorize with labels like side-project, ai, or mobile
    • Status — defaults to captured

    Hit Save and your first idea is live. If NeuralRepo detects a similar existing idea, you will see a duplicate warning before saving.

  3. Install the CLI

    Open your terminal and install the NeuralRepo CLI globally:

    Terminal window
    npm install -g @neuralconfig/nrepo

    Verify the installation:

    Terminal window
    nrepo --version

  4. Log in from the CLI

    Authenticate the CLI with your NeuralRepo account:

    Terminal window
    nrepo login

    This opens your browser for OAuth authentication. Once approved, the CLI stores your session locally in ~/.config/neuralrepo/config.json.

  5. Capture an idea from the CLI

    Push your first idea directly from the terminal:

    Terminal window
    nrepo push "Build a habit tracker app" --tag side-project --status exploring

    You should see output confirming the idea was created:

    Idea created successfully
      ID:     42
      Title:  Build a habit tracker app
      Status: exploring
      Tags:   side-project

  6. Search your ideas

    Find ideas using semantic search:

    Terminal window
    nrepo search "habit tracker"

    This returns matching ideas ranked by relevance. On the Pro plan, search uses vector similarity — so it finds ideas by meaning, not just keywords.

  7. Connect Claude AI via MCP (optional)

    If you use Claude, you can let it read and write ideas directly through the Model Context Protocol.

    In Claude.ai settings, add a new remote MCP server with this URL:

    https://neuralrepo.com/mcp/

    On first use, Claude will prompt you to authorize NeuralRepo via OAuth.

    Once connected, you can say things like “Save this as an idea in NeuralRepo” or “Search my ideas for authentication patterns” and Claude handles the rest.

  8. Try the AI agent (Pro)

    On Pro, the NeuralRepo web app includes a built-in AI agent. Open the Neural Canvas tab to start a conversation, or open the Mind Map and click the agent icon in the bottom-right corner.

    Select a model — Workers AI models (Qwen 30B, Llama 70B) work without any API key. For Anthropic models (Sonnet, Haiku, Opus), add your key first in Settings > AI Providers.

    Try asking:

    • “What am I working on?”
    • “Find connections between my recent ideas”
    • “Brainstorm 3 variations of my top idea”

    See the AI Agent docs for the full list of capabilities.

Next Steps

Section titled “Next Steps”
Core Concepts Understand ideas, statuses, tags, relations, and the idea graph.
CLI Reference Explore all available nrepo commands.
MCP Integration Deep dive into the Claude AI integration.
Plans & Pricing Compare free and Pro features.