Skip to main content

​
Prerequisites

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

​
Step 1: Install the CLI

pip install nogic
Verify: 
nogic --version

​
Step 2: Get Your API Key

  1. Go to nogic.dev and sign in
  2. Navigate to Settings → API Keys
  3. Click Create API Key
  4. Copy the key (starts with sk_)
Save your API key securely. You won’t be able to see it again.

​
Step 3: Login

nogic login
Paste your API key when prompted: 
Enter your API key: sk_...
✓ Logged in successfully

​
Step 4: Initialize Your Project

Navigate to your codebase and initialize: 
cd /path/to/your/project
nogic init
This creates a .nogic/config.json and syncs your code to Nogic.

​
Step 5: Verify It Works

nogic status
You should see: 
Nogic Project Status
========================================

Local Configuration:
  Project ID:     abc123-def456-...
  Backend URL:    https://api.nogic.dev
  Logged in:      Yes

Backend Status:
  ✓ Connected
  ✓ Project found

​
Step 6: Connect Your AI Agent

Add Nogic to your AI agent’s MCP config:
Create .mcp.json in your project root:
{
  "mcpServers": {
    "nogic": {
      "url": "https://api.nogic.dev/mcp?api_key=YOUR_API_KEY"
    }
  }
}
Replace YOUR_API_KEY with your actual key.

​
Step 7: Test It

In your AI agent, try:
“Use nogic to list all files in this project”
Or:
“Use nogic to find functions similar to user authentication”

​
Next Steps

CLI Commands

Full CLI reference

MCP Tools

Available MCP tools