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 every supported AI coding agent on the machine automatically:
The only output you should see is:
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. Your AI coding agents — Claude Code, Codex, Cursor, OpenCode, and Kiro — will now capture sessions across all your projects and send them to the Cogniscape knowledge graph automatically. What each agent provides is listed in the capability matrix.
An agent installed after Cogniscape is picked up automatically, within about an hour of the next captured session. Kiro IDE, Kiro CLI, and Kiro Crew have one-time requirements (trusted workspace, v3 engine, restart) — see Agent requirements.

Uninstall

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

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.