1
Install the CLI
Run the install script with your customer key — it downloads the binary, saves your key to
The only output you should see is:
~/.cogniscape/config.json, and installs hooks for every supported AI coding agent on the machine automatically:- macOS / Linux
- Windows (PowerShell)
Your customer key is stored in
~/.cogniscape/config.json — machine-level, shared across all
projects. You only need to configure it once per machine.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.- Claude (web, Desktop, mobile)
- Claude Code
Configure once on claude.ai and the connector is automatically available
on Claude Desktop, iPhone, and Android under the same account.
- Open the Add custom connector dialog directly.
- Name:
Cogniscape. - Remote MCP server URL:
https://mcp.cogniscape.app. - 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.