> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cogniscape.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Setup

> Get Cogniscape running in one command.

<Steps>
  <Step title="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:

    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={null}
        curl -fsSL https://install.cogniscape.app/cogniscape.sh | sh -s -- <your-customer-key>
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={null}
        & ([scriptblock]::Create((irm https://install.cogniscape.app/cogniscape.ps1))) "<your-customer-key>"
        ```
      </Tab>
    </Tabs>

    The only output you should see is:

    ```
    SUCCESS
    ```

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

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.

<Note>
  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.
</Note>

## Uninstall

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

```bash theme={null}
cogniscape uninstall
```

## Connect your Claude client

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

<Tabs>
  <Tab title="Claude (web, Desktop, mobile)">
    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](https://claude.ai/settings/connectors?modal=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.

    <Note>
      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.
    </Note>
  </Tab>

  <Tab title="Claude Code">
    Run this in your terminal to add Cogniscape across all projects:

    ```bash theme={null}
    claude mcp add --transport http --scope user cogniscape https://mcp.cogniscape.app
    ```
  </Tab>
</Tabs>

For Cursor, Codex, and OpenCode setup, see the [MCP setup guide](/mcp-reader/setup).