Skip to main content
1

Install the CLI

Run the install script with your customer key — it downloads the binary, saves your key to ~/.cogniscape/config.json, and installs Claude Code hooks automatically:
curl -fsSL https://install.cogniscape.app/cogniscape.sh | sh -s -- <your-customer-key>
The only output you should see is:
SUCCESS
To install to a different directory, set COGNISCAPE_INSTALL_DIR before running:
COGNISCAPE_INSTALL_DIR=/usr/local/bin \
  curl -fsSL https://install.cogniscape.app/cogniscape.sh | sh -s -- <your-customer-key>
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 will now capture sessions, tasks, and plans across all your projects and send them to the Cogniscape knowledge graph automatically.

​
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 MCP Reader to your client config. 
{
  "mcpServers": {
    "cogniscape-reader": {
      "type": "http",
      "url": "https://server.cogniscape.app/mcp-reader/mcp?customer_key=<customer_key>"
    }
  }
}
Restart your Claude client after editing the config.