Documentation

Authorize every action your AI agents take

Start with a free, local Agent Environment Review. Map what every agent can do, find where its authority is ungranted, and close the gap.

The model

Runtime governance is delivered in order. You cannot enforce a boundary you have not authorized, or authorize an agent you have not identified — so the sequence is the product.

01

Review

Map what every agent in your workspace can actually reach — repo, shell, MCP tools, secrets, deploy.

02

Identity

Name each agent that acts: type, owner, session, capability profile, trust score.

03

Authorization

Compare what an agent can do against what it was granted. The difference is a gap.

04

Protect

Enforce the boundary at the action — allow, deny, escalate, rewrite, quarantine, terminate.

05

Control

Policy, approvals, and audit across every agent and workspace from one place.

06

Runtime

Governance that lives where actions happen — before execution, not after the fact.

Go deeper

The contracts and reasoning behind each tier.

Install

There are two ways to run DeepSweep, and both are apps you open rather than commands you type.

Governance Studio (desktop)

One desktop app that reviews every coding agent on the machine. It arrives as a signed installer from deepsweep.ai — nothing to fetch from a package registry, and nothing added to your PATH.

Studio builds are in early access. See how the Studio works and add your address to the list — the macOS and Windows builds go out to it first. There is no download link yet, because there is not yet a build to hand you.

Editor extension

The same review, inside the editor you already use. Install DeepSweep in VS Code, or search DeepSweep in the Extensions panel on Cursor and Windsurf (Open VSX). It runs locally — nothing but metadata leaves your machine.

Run a review

Review the agents operating in your workspace:

  1. In the Studio — open the app and pick the project folder. It finds the agent configurations already in the repository.
  2. In your editor — open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and choose Review Agent Environment.

Either way the review runs on your machine, and takes about a minute.

Example review

Agent Environment Review

Checking ....
  [INFO] Loaded 16 security rules
  [INFO] Reviewing AI assistant configurations

[CRITICAL] .cursorrules:1
  Your AI assistant can be tricked into ignoring safety rules.
  Fix: remove instructions that tell the AI to ignore previous
  instructions or override safety settings.

Grade: C (75/100)
1 files checked • 1 issue found

Every finding names the file and line, says why it matters in plain English, and gives you a fix you can hand straight to your coding assistant. The run ends with a grade for the project. In CI the same review reports its grade, score and finding count as step outputs — see below.

CI/CD

Review every pull request in your pipeline. The engine ships inside the Action and runs on your runner, so nothing is installed and no source leaves the machine. The pull-requests: write permission is what lets the Action post the result on the pull request, where the rest of your team sees it.

.github/workflows/deepsweep.yml
name: DeepSweep
on: [push, pull_request]

permissions:
  contents: read
  pull-requests: write

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Agent Environment Review
        uses: deepsweep-ai/action@v1
        with:
          path: .

To turn the review into a merge gate, add fail-below-score. It takes the posture score, 0–100. The job fails when the score is under the number you set, and also when there is no agent configuration in the repository to score — a threshold that cannot be evaluated is never quietly treated as a pass.

Pick the number deliberately, because it decides how often the build goes red. The bands are weak below 40, fair to 69, good to 89 and strong above that. Starting at 40 blocks only genuinely weak posture, which is the useful signal on a repository nobody has hardened yet. Raise it to 70 once the team has closed its gaps and wants to hold the line at good.

.github/workflows/deepsweep.yml — with a merge gate
      - name: Agent Environment Review
        uses: deepsweep-ai/action@v1
        with:
          path: .
          fail-below-score: 70

Detection patterns

The editor extension ships 77 patterns (37 AI-specific + 40 traditional), aligned with the OWASP LLM Top 10. The AI-specific set breaks down as:

Credential Exposure
16 patterns
Prompt Injection
7 patterns
MCP Security
7 patterns
Misconfiguration
4 patterns
Data Exfiltration
2 patterns
Supply Chain
1 pattern

The review that runs in the Studio and in CI focuses on AI assistant configuration files and currently ships 16 rules; the Studio lists every one of them, with what each rule looks for.

Supported AI assistants

AssistantConfig files
Cursor.cursorrules, .cursor/rules, .cursor/mcp.json
GitHub Copilotcopilot-instructions.md, .github/copilot-instructions.md
Claudeclaude_desktop_config.json, .claude/config.json
Windsurf.windsurfrules, .windsurf/rules
MCP (any client)mcp.json, .mcp/config.json

Configuration

Telemetry

DeepSweep collects anonymous usage data. No source code is ever collected. Privacy settings in the Studio and the extension show exactly what is enabled, and turn it off in one click.

For air-gapped machines, set DEEPSWEEP_OFFLINE=1 in the environment and nothing leaves the host at all.

Review strictness

Two decisions shape a review: the severity that counts as a failure, and whether MCP configuration checking is included. Both are settings, not flags. In CI the same threshold is the Action's fail-below-score input, so a local review and a pipeline review agree on what a failure is.

Run your first review

It is free, local, and takes about a minute.