claudeers.
// Security & Compliance

agentaudit

Reads a repository's AI coding agent configuration and reports what it can do: hooks, MCP servers, credential helpers, environment variables, permission and…

// Security & Compliance[ cli ][ api ][ claude ]#claude#agents#claude-code#codex#cursor#security◷ Apache-2.0$open-sourceupdated 10 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up agentaudit (claude-plugin project) into my current project.
Found on https://claudeers.com/agentaudit
Repo: https://github.com/manifold-security/agentaudit
Homepage/docs: —
Detected install method: claude-plugin → /plugin install agentaudit@manifold-security/agentaudit
Category: security. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)

⚠ Unverified / not recently updated — review before pasting a run-this config.

/plugin marketplace add manifold-security/agentaudit
/plugin install agentaudit@manifold-security/agentaudit
// or clone
git clone https://github.com/manifold-security/agentaudit

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseApache-2.0
Pricingopen-source
LanguageGo

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

agentaudit

agentaudit reads a repository's AI coding agent configuration and reports what it can do: the hooks, MCP servers, credential helpers, environment variables, permission and sandbox settings an agent picks up when it opens the repository. It only reads configuration; it never runs or modifies it.

It currently supports Claude Code, Codex and Cursor.

Install

With Go

go install github.com/manifold-security/agentaudit/cmd/agentaudit@latest

go install needs Go 1.26.0 or later.

From a release archive

Download the archive for your platform and SHA256SUMS from Releases, or with the GitHub CLI as below. Check the checksum and the attestation before you run the binary.

macOS

On an Intel Mac, replace darwin_arm64 with darwin_amd64.

gh release download -R manifold-security/agentaudit -p agentaudit_darwin_arm64.tar.gz -p SHA256SUMS
shasum -a 256 --ignore-missing -c SHA256SUMS
gh attestation verify agentaudit_darwin_arm64.tar.gz --repo manifold-security/agentaudit --signer-workflow manifold-security/agentaudit/.github/workflows/release.yml
tar -xzf agentaudit_darwin_arm64.tar.gz agentaudit
mkdir -p ~/.local/bin && mv agentaudit ~/.local/bin/

If macOS refuses to run it, clear the quarantine mark: xattr -d com.apple.quarantine ~/.local/bin/agentaudit.

If ~/.local/bin is not on your PATH, add this line to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Linux

On arm64, replace linux_amd64 with linux_arm64.

gh release download -R manifold-security/agentaudit -p agentaudit_linux_amd64.tar.gz -p SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS
gh attestation verify agentaudit_linux_amd64.tar.gz --repo manifold-security/agentaudit --signer-workflow manifold-security/agentaudit/.github/workflows/release.yml
tar -xzf agentaudit_linux_amd64.tar.gz agentaudit
mkdir -p ~/.local/bin && mv agentaudit ~/.local/bin/

If ~/.local/bin is not on your PATH, add this line to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Windows

In PowerShell:

gh release download -R manifold-security/agentaudit -p agentaudit_windows_amd64.zip -p SHA256SUMS
(Get-FileHash -Algorithm SHA256 .\agentaudit_windows_amd64.zip).Hash.ToLower() -eq ((Select-String -Path SHA256SUMS -SimpleMatch 'agentaudit_windows_amd64.zip').Line -split '\s+')[0]
gh attestation verify agentaudit_windows_amd64.zip --repo manifold-security/agentaudit --signer-workflow manifold-security/agentaudit/.github/workflows/release.yml
Expand-Archive .\agentaudit_windows_amd64.zip -DestinationPath agentaudit
Unblock-File .\agentaudit\agentaudit.exe

The second line must print True. Then move agentaudit\agentaudit.exe to a directory on your PATH.

From source

make build                          # builds dist/agentaudit
mkdir -p ~/.local/bin && mv dist/agentaudit ~/.local/bin/

Quick start

Scan a repository from anywhere by naming it, or cd into it and run the command with no argument:

agentaudit /path/to/repo
cd /path/to/repo && agentaudit
agentaudit https://github.com/wshobson/agents

A GitHub URL scans a public repository without cloning it.

Sample output, from agentaudit testdata/malicious/claude-guardrail in this repository:

agentaudit · testdata/malicious/claude-guardrail

(claude-code)
permissions:
  mcpApproval enableAllProjectMcpServers · true · .claude/settings.json:enableAllProjectMcpServers
  mcpApproval enabledMcpjsonServers · memory · .claude/settings.json:enabledMcpjsonServers[0]
  permissionMode · acceptEdits · .claude/settings.json:permissions.defaultMode

sandbox:
  sandbox · /var/run/docker.sock · .claude/settings.json:sandbox.network.allowUnixSockets[0]
  sandbox · /tmp/app.sock · .claude/settings.json:sandbox.network.allowUnixSockets[1]

5 capabilities · 1 file · 2 categories

What it reports

Findings are grouped by agent ((claude-code), (codex), (cursor)), then by category. Each line is one capability: what it is, the value it carries, and where it is declared (file and key). The footer counts the capabilities, the files they came from, and the categories.

A finding's id in the JSON and Markdown reports is a hash over the scanned value, so a published report can confirm a guessed weak secret. The ids are kept stable on purpose.

CategoryMeaning
code-executionruns a command, script or server process: hooks, MCP servers, credential helpers, status lines, bundled scripts, NODE_OPTIONS, PATH
credential-accesspasses a value from your environment to a server or command
network-accessreaches the network or redirects where traffic goes: API base URLs, proxies
permissionswidens what runs without asking you: approval modes, auto-approved MCP servers
sandboxturns off or changes the agent's sandbox, or admits a Unix socket
filesystem-accessgrants read or write access to a path

A repository whose agent configuration yields nothing prints no capabilities found followed by the agents it scanned; one with no agent configuration at all prints no known agent config read.

Under --global-config, a home directory with no agent configuration prints no user-level agent config found, and one that exists but cannot be opened prints user-level agent config could not be read.

Exit codes: 0 no findings and every source read, 1 at least one finding, a source the scan could not read or parse (SCAN INCOMPLETE), a home directory --global-config could not open, a file a scan limit refused or a file a URL fetch withheld, 2 usage or runtime error. A refused file is named in a warning on stderr; when the limit that refused it has a flag below, a closing hint: line names that flag.

Flags

Usage: agentaudit [PATH | URL]. PATH defaults to the current directory. URL is https://github.com/<owner>/<repo>[/tree/<ref>[/<path>]], fetched anonymously over the network and held in memory; the fetch has a 120 s limit, and the report header reads github.com/<owner>/<repo>[/tree/<ref>[/<path>]]@<commit>, the commit cut to 12 characters.

FlagBehaviour
-v, --explainAdds each finding's rule id, message and reference link. Pretty output only.
-o, --output pretty|jsonFormat printed to stdout. Default pretty.
-O, --output-file json|md|allAlso writes agentaudit-report.json, agentaudit-report.md, or both, to the current directory. Nothing is written without this flag.
-r, --recursiveScans every project beneath PATH or URL, one report block per project.
--scan-dir <path>Adds another directory, scanned alongside PATH; a URL here exits 2. Repeatable.
--global-configScans only each agent's user-level configuration in your home directory. Cannot be combined with PATH, --scan-dir or -r.
--max-file-size <bytes>Refuses a file larger than this, in bytes or with a KiB, MiB or GiB suffix (2MiB). Default 512KiB; 0 turns the limit off. Raise it when a legitimate file is refused, such as a large ~/.claude.json under --global-config.
--max-read-bytes <bytes>Refuses reads past this total in one scan, in bytes or with a KiB, MiB or GiB suffix. Default 64MiB; 0 turns the limit off.
--max-entities <n>Refuses a file that would take one agent's parse past this many items. Default 10,000; 0 turns the limit off.
-V, --versionPrints the version and exits.

Examples

Show the rule behind each finding:

$ agentaudit -v testdata/malicious/claude-guardrail
...
permissions:
  mcpApproval enableAllProjectMcpServers · true · .claude/settings.json:enableAllProjectMcpServers
    claude.mcp.auto-approve — MCP auto-approve bypasses the per-server approval prompt — https://code.claude.com/docs/en/settings
...

Print JSON for another tool to consume:

agentaudit -o json /path/to/repo

Print the report and also save JSON and Markdown copies:

agentaudit -O all /path/to/repo   # writes ./agentaudit-report.json and ./agentaudit-report.md

Scan every project under a directory:

agentaudit -r /path/to/projects

Scan two repositories in one run:

agentaudit /path/to/repo --scan-dir /path/to/other-repo

Scan only your own user-level agent configuration:

agentaudit --global-config

Admit a user-level config larger than the default file limit:

agentaudit --global-config --max-file-size 4MiB

Library usage

Import github.com/manifold-security/agentaudit to scan from Go. A scan reads through an fs.FS; for a directory on disk, pass an os.Root's FS, which keeps reads inside the directory. This scans the sample fixture in this repository:

root, err := os.OpenRoot("testdata/malicious/claude-guardrail")
if err != nil {
	log.Fatal(err)
}
defer root.Close()

report, err := agentaudit.New().Scan(root.FS())
if err != nil {
	log.Fatal(err)
}
for _, f := range report.Findings() {
	fmt.Println(f.RuleID, f.Digest())
}
fmt.Println("unreadable:", report.UnreadableSources(), "unparsed:", report.UnparsedSources())

The Go API is pre-1.0, so a release may change it.

Supported platforms

OSamd64arm64
Linuxagentaudit_linux_amd64.tar.gzagentaudit_linux_arm64.tar.gz
macOSagentaudit_darwin_amd64.tar.gzagentaudit_darwin_arm64.tar.gz
Windowsagentaudit_windows_amd64.zipagentaudit_windows_arm64.zip

License

Apache-2.0. See LICENSE and NOTICE.

// faq

What is agentaudit?

Reads a repository's AI coding agent configuration and reports what it can do: hooks, MCP servers, credential helpers, environment variables, permission and sandbox settings. Supports Claude Code, Cursor and Codex.. It is open-source on GitHub.

Is agentaudit free to use?

agentaudit is open-source under the Apache-2.0 license, so it is free to use.

What category does agentaudit belong to?

agentaudit is listed under security in the Claudeers registry of Claude-compatible tools.

10 views
★ 12 stars
unclaimed
updated 10 days ago

// embed badge

agentaudit on Claudeers
[![Claudeers](https://claudeers.com/api/badge/agentaudit.svg)](https://claudeers.com/agentaudit)

// retro hit counter

agentaudit hit counter
[![Hits](https://claudeers.com/api/counter/agentaudit.svg)](https://claudeers.com/agentaudit)

// reviews

// guestbook

0/500

// related in Security & Compliance

🔓

A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specia…

// securitymsitarzewski/⟨Shell⟩★ 166,547◷ MIT[ claude ]
🔓

π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.

// securityruvnet/⟨Rust⟩★ 104,461◷ MIT[ claude ]
🔓

Prowler is the world’s most widely used open-source cloud security platform that automates security and compliance across any cloud environment.

// securityprowler-cloud/⟨Python⟩★ 15,171◷ Apache-2.0[ claude ]
🔓

🐶 A curated list of Web Security materials and resources.

// securityqazbnm456/⟨Python⟩★ 14,058[ claude ]
→ see how agentaudit connects across the ecosystem