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

# Installation

> Install and set up the ZeroPath CLI on your system

## Installation Methods

<Tabs>
  <Tab title="macOS Intel">
    ```bash theme={null}
    wget https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-macos -O zeropath
    chmod +x zeropath
    sudo mv zeropath /usr/local/bin/
    ```
  </Tab>

  <Tab title="macOS ARM (M1/M2)">
    ```bash theme={null}
    wget https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-macos-arm64 -O zeropath
    chmod +x zeropath
    sudo mv zeropath /usr/local/bin/
    ```
  </Tab>

  <Tab title="Linux x64">
    ```bash theme={null}
    wget https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-linux -O zeropath
    chmod +x zeropath
    sudo mv zeropath /usr/local/bin/
    ```
  </Tab>

  <Tab title="Windows x64">
    ```powershell theme={null}
    Invoke-WebRequest -Uri https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-windows.exe -OutFile zeropath.exe
    move zeropath.exe "C:\Windows\System32\"
    ```
  </Tab>
</Tabs>

<Card title="Download Latest Release" icon="download" href="https://github.com/ZeroPathAI/zeropath-cli/releases/latest">
  Get the latest release directly from GitHub
</Card>

## Verify Installation

After installation, verify the CLI is working:

```bash theme={null}
# Check if installed correctly
zeropath --version

# View available commands
zeropath --help
```

## Authentication

Connect the CLI to your ZeroPath account using API credentials:

```bash theme={null}
# Authenticate with your Client ID and Client Secret
zeropath auth <clientId> <clientSecret>
```

### Getting API Credentials

1. Sign in to [ZeroPath Dashboard](https://zeropath.com/app)
2. Navigate to API Settings or Account Settings
3. Generate new API credentials (Client ID and Client Secret)
4. Save these credentials securely

## First Scan

Once authenticated, you can start scanning:

```bash theme={null}
# Scan current directory and save results
zeropath scan . output.sarif

# Scan a specific directory
zeropath scan /path/to/your/project results.sarif
```

## Common Usage Patterns

### Local Development

```bash theme={null}
# Quick scan of current project
zeropath scan . results.sarif

# Scan specific directory
zeropath scan ./src output.sarif
```

### CI/CD Integration

```bash theme={null}
# Repository scanning by ID (exits 1 if issues found)
zeropath scan --repository-id <repositoryId>

# Repository scanning by URL
zeropath scan --repository-url https://github.com/owner/repo --vcs github
```

## Next Steps

* [CLI Introduction](/cli/introduction) - Learn about CLI capabilities
* [GitHub Repository](https://github.com/ZeroPathAI/zeropath-cli) - Source code and latest releases
* [API Reference](/api-reference/introduction) - API documentation for advanced usage