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 hooks for Claude Code and Cursor automatically:
curl -fsSL https://install.cogniscape.app/cogniscape.sh | sh -s -- <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.
Configure once on claude.ai and the connector is automatically available on Claude Desktop, iPhone, and Android under the same account.
  1. Open the Add custom connector dialog directly.
  2. Name: Cogniscape.
  3. Remote MCP server URL: https://mcp.cogniscape.app.
  4. Click Add and complete the OAuth login with your Cogniscape account.
The installed Claude Desktop app does not accept Streamable HTTP connectors directly. Configuration must come from the web account, which is the single source of truth across all Claude surfaces.
For Cursor, Codex, and OpenCode setup, see the MCP setup guide.