> ## 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.

# Installation

> Install the cogniscape CLI on your machine.

<Tabs>
  <Tab title="macOS / Linux">
    The install script downloads the binary for your platform, places it in `~/.local/bin`, saves your customer key, and installs Claude Code hooks automatically:

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

    The only output you should see is:

    ```
    SUCCESS
    ```

    ### Custom install directory

    ```bash theme={null}
    COGNISCAPE_INSTALL_DIR=/usr/local/bin \
      curl -fsSL https://install.cogniscape.app/cogniscape.sh | sh -s -- <your-customer-key>
    ```

    ### Specific version

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

  <Tab title="Windows (PowerShell)">
    Open PowerShell and run:

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

    The only output you should see is:

    ```
    SUCCESS
    ```

    The binary is installed to `%LOCALAPPDATA%\Programs\cogniscape\` and added to your user PATH automatically.

    <Note>
      If PowerShell blocks the script, run this first:

      ```powershell theme={null}
      Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
      ```
    </Note>

    ### Specific version

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

    ### Custom install directory

    ```powershell theme={null}
    $env:COGNISCAPE_INSTALL_DIR = "C:\tools\cogniscape"
    & ([scriptblock]::Create((irm https://install.cogniscape.app/cogniscape.ps1))) "<your-customer-key>"
    ```

    <Warning>
      After installation, open a **new terminal** to use the `cogniscape` command — PATH changes only take effect in new sessions.
    </Warning>
  </Tab>
</Tabs>

## Verify the installation

```bash theme={null}
cogniscape version
# cogniscape (go) v1.4.0
```

<Note>
  If `cogniscape` is not found after installation, ensure your install directory is in your `PATH`:

  * **macOS/Linux**: `~/.local/bin` (or your custom install directory)
  * **Windows**: `%LOCALAPPDATA%\Programs\cogniscape\` (added automatically by the installer)
</Note>