On this page

According to GitHub's official documentation, developers can install the github-security plugin in the GitHub Copilot app to unlock a dedicated Security canvas for triaging alerts and reviewing local changes. The extension is in public preview and remains subject to change.

Prerequisites & Installation Steps

You need an active Copilot plan, the GitHub Copilot app, and a signed-in GitHub account (plus administrator approval if your organization restricts Copilot plugins or app policies). Installing the plugin enables the extension automatically via either method:

Terminal (Copilot CLI): Run copilot plugin install github-security@awesome-copilot.

In the Copilot App: Open Sidebar → Customize, search for github-security, and click + Install next to Plugins.

Managing Code Scanning Alerts & Running Local Security Reviews

Code Scanning Alerts Only (GitHub.com & GHEC): The Security canvas lists code scanning alerts sorted by severity for repositories on GitHub.com and GitHub Enterprise Cloud with data residency—it does not show Dependabot or secret scanning alerts, and GitHub Enterprise Server is not supported. Viewing existing alerts requires repository alert permissions and enabled code scanning (plus GitHub Code Security for private repositories).

Explain & Local-Only Fix Behavior: Selecting an alert lets the Copilot agent explain the issue or edit your local working copy. Fix modifies local files only—it does not commit, push, open a pull request, or close the alert on GitHub until the fix lands on the affected branch and a subsequent code scanning run confirms resolution.

Alert Dismissal & Delegated Approval: Dismissing an alert updates its status on GitHub if you hold permission; when delegated alert dismissal is enforced, the extension submits a dismissal request that must be approved on GitHub.

Pre-PR Local Security Review (/security-review): Clicking Start review on the Security canvas or running /security-review in a session performs a focused review of current local changes. Local review requires neither enabled code scanning nor a GitHub Code Security license, though it is not a full-repository audit and does not replace code scanning.

Tool Permissions & AI Credits Rules

When AI Credits Are Consumed: Extension tools follow standard Copilot app tool permission prompts. Browsing and dismissing alerts in the canvas consume zero AI credits, whereas clicking Explain, Fix, or starting a security review invokes the selected model in the app and consumes AI credits like standard prompts.