Quick Setup - Cogniscape

Install the CLI

Run the install script with your customer key — it downloads the binary, saves your key to ~/.cogniscape/config.json, and installs hooks for Claude Code and Cursor automatically:

macOS / Linux
Windows (PowerShell)

curl -fsSL https://install.cogniscape.app/cogniscape.sh | sh -s -- <your-customer-key>

& ([scriptblock]::Create((irm https://install.cogniscape.app/cogniscape.ps1))) "<your-customer-key>"

The only output you should see is:

SUCCESS

Your customer key is stored in ~/.cogniscape/config.json — machine-level, shared across all projects. You only need to configure it once per machine.

That’s it. Claude Code and Cursor will now capture sessions, tasks, and plans across all your projects and send them to the Cogniscape knowledge graph automatically.

Cursor hooks are installed automatically when ~/.cursor/ is detected on the machine. If you install Cursor after Cogniscape, run cogniscape init <your-key> again to pick up the Cursor hooks.

Uninstall

To fully remove Cogniscape from the machine (removes hooks and the binary):

cogniscape uninstall

Connect your Claude client

To query your knowledge graph from Claude, add the Cogniscape MCP to your client config.

Claude Desktop (automatic)
Claude Desktop (manual)
Claude Code

The fastest way — one command, zero manual JSON editing:

cogniscape setup mcp

This reads your customer key from ~/.cogniscape/config.json and injects the cogniscape-reader MCP server into Claude Desktop’s config automatically. Restart Claude Desktop to activate the connection.

To remove the MCP server later:

cogniscape setup mcp --uninstall

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "cogniscape-reader": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.cogniscape.app/mcp-reader/mcp?customer_key=<customer_key>"]
    }
  }
}

Restart Claude Desktop after saving.

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "cogniscape-reader": {
      "type": "http",
      "url": "https://api.cogniscape.app/mcp-reader/mcp?customer_key=<customer_key>"
    }
  }
}

Overview

​Uninstall

​Connect your Claude client

Uninstall

Connect your Claude client