Skip to main content

​
Prerequisites

  • Python 3.11 or higher
  • A Nogic account at nogic.dev

​
Step 1: Install the CLI

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install nogic
Or with pip: 
pip install nogic
Verify: 
nogic --version
See the installation guide for more options.

​
Step 2: Get Your API Key

  1. Go to nogic.dev/dashboard (or sign in at nogic.dev and open the Dashboard)
  2. Click Create API Key
  3. Copy the key (starts with sk_)
Save your API key immediately. You won’t be able to see it again.

​
Step 3: Login

nogic login
Paste your API key when prompted: 
> Get your API key from the Nogic dashboard.

Paste your API key:
> Logged in as a1b2c3d4...
  API key saved. You're ready to go.

  Next: run `nogic init` in a project directory.

​
Step 4: Initialize Your Project

Navigate to your codebase and initialize: 
cd /path/to/your/project
nogic init

> Created project 'my-project'

────────────── nogic init ──────────────
  Directory: /path/to/your/project
  Project:   my-project
  Project ID: a1b2c3d4-...

Ready to sync: nogic watch

​
Step 5: Index Your Code

Start watching for changes to index your codebase: 
nogic watch
This performs an initial full index and then watches for file changes. Press Ctrl+C to stop. For a one-time sync instead: 
nogic sync

​
Step 6: Connect Your AI Agent

Follow the setup guide for your AI agent:

Claude Code

Connect Nogic to Claude Code CLI

Cursor

Connect Nogic to Cursor IDE

Windsurf

Connect Nogic to Windsurf

Other Editors

VS Code, Antigravity, and more

​
Step 7: Test It

In your AI agent, try:
“Use nogic to find functions similar to user authentication”
Or:
“Use nogic to check for existing code before writing a new validation function”

​
Next Steps

CLI Commands

Full CLI reference

MCP Tools

Available MCP tools