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

# Install the Semgrep CLI for Guardian

> Install and sign in to the Semgrep CLI for Guardian integrations that run scans locally.

This page applies only if you use a coding agent other than Claude Code or Codex, or if you run the [local Claude Code plugin](/semgrep-guardian/ide-setup/claude-code#run-semgrep-guardian-locally). **The Claude Code and Codex plugins are recommended** and don't require a local Semgrep CLI. Prefer the [Quickstart](/semgrep-guardian/quickstart) unless you specifically need a local CLI integration.

<Steps>
  <Step>
    Install the Semgrep CLI using pipx, uv, or Homebrew. This requires Python 3.10 or later -- the Semgrep CLI needs Python at runtime regardless of how you installed the CLI:

    ```bash theme={null}
    # preferred: install using pipx (https://pipx.pypa.io/stable/how-to/install-pipx/)
    pipx install semgrep

    # preferred: install using uv (https://docs.astral.sh/uv/)
    uv tool install semgrep

    # best-effort (macOS): install using Homebrew (maintained on a best-effort basis; often lags behind the latest release)
    brew install semgrep
    ```

    <Info>
      **NOTE**

      `pipx` and `uv` are the preferred installation methods. The Homebrew formula is maintained on a best-effort basis and often lags behind the latest release.

      **Homebrew users:** ensure that you've [added Homebrew to your PATH](https://docs.brew.sh/FAQ#my-mac-apps-dont-find-homebrew-utilities).
    </Info>
  </Step>

  <Step>
    Verify that you've installed the [latest version](https://github.com/semgrep/semgrep/releases) of Semgrep:

    ```bash theme={null}
    semgrep --version
    ```
  </Step>

  <Step>
    Sign in to your Semgrep account and install the Semgrep Pro Engine:

    ```bash theme={null}
    semgrep login && semgrep install-semgrep-pro
    ```

    `semgrep login` launches a browser window. You can also use the activation link printed in the terminal.
  </Step>
</Steps>

## Next steps

Return to [Choose your setup](/semgrep-guardian/choose-your-setup) and pick your coding agent to finish configuring Guardian.