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

# Run scans on pre-commit

The [pre-commit framework](https://pre-commit.com/) can run `semgrep` when you commit changes. This is helpful in preventing secrets and security issues from leaking into your Git history.

## Prerequisites

[<Icon icon="external-link" iconType="solid" /> The `pre-commit` framework](https://pre-commit.com).

## `pre-commit` with Semgrep Community Edition (no login)

Use these instructions to run `pre-commit` without logging in. You can still use custom rules or rules from the Semgrep Registry.

Add the following to your `.pre-commit-config.yaml` file:

```yaml theme={null}
repos:
- repo: https://github.com/semgrep/pre-commit
  rev: 'v1.166.0'
  hooks:
    - id: semgrep
      entry: semgrep
      # Replace <SEMGREP_RULESET_URL> with your custom rule source
      # or see https://semgrep.dev/explore to select a ruleset and copy its URL
      args: ['--config', '<SEMGREP_RULESET_URL>', '--error', '--skip-unknown-extensions']
```

## `pre-commit` with your Semgrep AppSec Platform configuration

You can also run custom rules and rulesets from Semgrep AppSec Platform, similar to running `semgrep ci`.

Ensure that you are logged in:

<Steps>
  <Step>
    Log in to your Semgrep account. Running this command launches a browser window, but you can also use the link that's returned in the CLI to proceed:

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

  <Step>
    In the **Semgrep CLI login**, click **Activate** to proceed.
  </Step>
</Steps>

Add the following to your `.pre-commit-config.yaml` file:

```yaml theme={null}
repos:
- repo: https://github.com/semgrep/pre-commit
  rev: 'v1.166.0'
  hooks:
    - id: semgrep-ci
```

For guidance on customizing Semgrep's behavior in pre-commit, see [Customize Semgrep in pre-commit](/kb/integrations/customize-semgrep-precommit).