SecAgent AI
Autonomous AI Security Agent — scan, verify, and auto-fix security vulnerabilities in your codebase using xAI Grok.
pip install secagent-ai
What is SecAgent?
SecAgent is a CLI tool that acts as an autonomous security engineer. Point it at a file or directory and it will:
- Scan for secrets, vulnerabilities, and insecure code patterns
- Verify each finding with AI to eliminate false positives
- Fix real vulnerabilities by generating and applying secure patches
- Report everything in a readable Markdown report with cost tracking
All AI reasoning is powered by xAI Grok.
Installation
Requirements: Python 3.11+
pip install secagent-ai
On first run, SecAgent will walk you through a one-time setup to save your Grok API key:
secagent scan ./myproject
╔══════════════════════════════════════════╗
║ S E C A G E N T AI ║
║ Autonomous AI Security Agent v0.1.0 ║
╚══════════════════════════════════════════╝
──────────────── First-Time Setup ─────────
Welcome to SecAgent!
To get started, enter your xAI Grok API key.
Get one at: https://console.x.ai/
Grok API Key: ********************************
Setup complete! Config saved to: C:\Users\you\.secagent\config.json
Your key is saved locally and never sent anywhere except the xAI API.
Usage
Scan a file or directory
secagent scan ./myproject
secagent scan ./app/auth.py
Scans for vulnerabilities and saves results. Does not modify any files.
Scan and auto-fix
secagent fix ./myproject
secagent fix ./app/auth.py
Verifies findings, generates patches, applies fixes, and writes a fix.md report.
Re-configure your API key
secagent configure
Check version
secagent version
Verbose mode
secagent scan ./myproject --verbose
secagent fix ./myproject --verbose
Optional Tools
SecAgent works out of the box with its built-in scanners. Installing these tools unlocks additional scanning capabilities:
| Tool | Purpose | Install |
|---|---|---|
| Gitleaks | Secret & credential scanning | brew install gitleaks |
| Trivy | Dependency vulnerability scanning | brew install trivy |
SecAgent degrades gracefully — if a tool isn't installed, it's skipped automatically. The built-in scanner and AI scanner always run regardless.
How It Works
SecAgent runs a 9-stage pipeline:
Stage 1 │ Planner Agent │ Analyzes your codebase, selects the right scanners
Stage 2 │ Scanner Executor │ Runs all selected scanners in parallel
Stage 3 │ Result Parser │ Normalizes findings into a unified format
Stage 4 │ Deduplicator │ Merges duplicate findings across scanners
Stage 5 │ Verifier Agent │ AI classifies True Positive vs False Positive
Stage 6 │ Fixer Agent │ AI generates a secure patch for each real finding
Stage 7 │ Validator Agent │ AI confirms the patch is correct and safe
Stage 8 │ Patch Applier │ Applies the patch to your file (with backup)
Stage 9 │ Report Builder │ Generates fix.md + token usage cost report
All AI stages use xAI Grok. Stages 1, 5 use the fast non-reasoning model. Stages 6, 7 use the reasoning model for higher accuracy.
Output
After a fix run, SecAgent creates:
fix.md— full report of findings, verification results, patches applied, and skipped fixes.secagent/logs/cost.md— token usage and estimated API cost per stage.secagent/data/*.vulns.json— cached scan results (reused on subsequentfixruns)
Configuration
Your API key and model settings are stored at:
| Platform | Path |
|---|---|
| Windows | C:\Users\<you>\.secagent\config.json |
| Linux / Mac | ~/.secagent/config.json |
To update your key at any time:
secagent configure
Example Output
SecAgent v0.1.0
Scanning /home/user/myapp (directory)
[Stage 1] Planner selected: builtin-secrets, ai-scanner, gitleaks
[Stage 2] Running 3 scanners...
[Stage 3] Parsed 5 findings
[Stage 4] Deduplicated to 4 unique findings
[Stage 5] Verifying findings... 4 TP | 0 FP
[Stage 6] Fixing 4 vulnerabilities...
[Stage 7] Validating patches... 4 valid
[Stage 8] Applying 4 patches...
──────────────────────────────────────────────────
Findings: 4 TP: 4 FP: 0 Fixed: 4
Report generated: fix.md
┌─ Token Usage & Estimated Cost ──────────────────┐
│ Stage │ Model │ Tokens │ Cost (USD) │
│ planner │ fast │ 1,240 │ $0.0002 │
│ scanner │ reasoning │ 8,430 │ $0.0042 │
│ verifier │ fast │ 2,100 │ $0.0004 │
│ fixer │ reasoning │ 12,800 │ $0.0064 │
│ validator │ reasoning │ 6,300 │ $0.0032 │
│ Total │ │ 30,870 │ $0.0144 │
└─────────────────────────────────────────────────┘
License
MIT — free to use, modify, and distribute.
Links
- PyPI
- GitHub
- xAI Console — get your Grok API key
Metadata
Release files for secagent-ai 0.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| secagent_ai-0.1.6.tar.gz | 36.7 kB | Without provenance | Details for secagent_ai-0.1.6.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| secagent_ai-0.1.6-py3-none-any.whl | Python 3 | none | any | Details for secagent_ai-0.1.6-py3-none-any.whl |
Total release size: 85.6 kB
Release files / secagent_ai-0.1.6.tar.gz
| Download URL | secagent_ai-0.1.6.tar.gz |
|---|---|
| Size | 36.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d1426f8ed7e74674c0915c0186bb0eeee79f943698981ff06b932fe64175c448
|
|
BLAKE2b-256 checksum How to use checksums |
e5115ce67bceace7e7cbf7791b12030286d074f156868c455f5f17b361fbc6a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
Release files / secagent_ai-0.1.6-py3-none-any.whl
| Download URL | secagent_ai-0.1.6-py3-none-any.whl |
|---|---|
| Size | 48.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ea51704d66f00b230a29bf762706832db175ded73fb29f6b73de5adbd0fa9b8a
|
|
BLAKE2b-256 checksum How to use checksums |
a9ad372d3cc0e8576d95eacc4a17b907aa4c0002b9116c18dc34b1a44504f191
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
Security for secagent-ai 0.1.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.