Monitor and secure AI agents with guardrails. Pre-execution command blocking, PII filtering, and real-time security enforcement.
Project description
SudoDog
Find and monitor AI agents running on your machine.
pip install sudodog
sudodog-scan
┌─────────────────────────────────────────────────────────┐
│ 🐕 SudoDog Shadow Agent Scanner │
│ Find AI agents you didn't know were running │
└─────────────────────────────────────────────────────────┘
Scanning for AI agents...
Checking 142 processes...
============================================================
SHADOW AGENT SCAN REPORT
============================================================
Unmonitored Agents Found: 2
============================================================
[1] PYTHON (PID 12847)
Framework: langchain
Confidence: [████████░░] 80%
Command: python agent.py --model gpt-4
Why detected:
• Framework detected: langchain
• AI API connections: 1
[2] NODE (PID 9123)
Framework: unknown
Confidence: [██████░░░░] 60%
Command: node dist/agent-runner.js
Why detected:
• Command matches pattern 'agent'
• AI API connections: 3
What It Does
- Scans running processes for AI agent frameworks (LangChain, AutoGPT, CrewAI, etc.)
- Detects API connections to OpenAI, Anthropic, and other AI providers
- Works on macOS, Linux, and Windows
- Zero configuration - just run
sudodog-scan
Installation
pip install sudodog
Commands
Scan for AI agents
sudodog-scan # Quick scan
sudodog-scan --json # JSON output (for scripts)
sudodog-scan --watch # Continuous monitoring
Monitor your agents
# Initialize (optional - for dashboard features)
sudodog init
# Run your agent with monitoring
sudodog run python my_agent.py
# Or integrate with Claude Code
sudodog integrate claude-code
Detected Frameworks
| Framework | Detection Method |
|---|---|
| LangChain | Process args, imports, env vars |
| AutoGPT | Process args, imports |
| CrewAI | Process args, imports |
| OpenAI Assistants | API connections, imports |
| Anthropic Claude | API connections, imports |
| LlamaIndex | Process args, imports |
| Semantic Kernel | Process args, imports |
Dashboard (Optional)
See your agents in a web dashboard:
- Sign up at dashboard.sudodog.com
- Get your API key from Settings
- Run:
sudodog initand enter your API key - Your scans and monitored agents will appear in the dashboard
Use Cases
- Security teams: Find unauthorized AI agents in your environment
- Developers: See what AI tools are running and how much they're costing
- DevOps: Monitor AI agent health and API usage
- Compliance: Audit AI agent activity for regulatory requirements
Privacy
- Scans run locally on your machine
- No data is sent anywhere unless you explicitly use
--api-key - Open source: github.com/SudoDog-official/SudoDog
Links
- Website: sudodog.com
- Dashboard: dashboard.sudodog.com
- Docs: sudodog.com/docs
- GitHub: github.com/SudoDog-official/SudoDog
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sudodog-2.7.3.tar.gz
(75.2 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
sudodog-2.7.3-py3-none-any.whl
(89.3 kB
view details)
File details
Details for the file sudodog-2.7.3.tar.gz.
File metadata
- Download URL: sudodog-2.7.3.tar.gz
- Upload date:
- Size: 75.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8d20b6a70580e33e4e27a220c8a64105eb33c5a7e88943acb3629760b1348d20
|
|
| MD5 |
c277a2a8010ad4d1ee28a2a9bcf67c5a
|
|
| BLAKE2b-256 |
046fcd30a401a7cc9067fb5b31f20a18b43bab96717c48d3724088ad7c63f05c
|
File details
Details for the file sudodog-2.7.3-py3-none-any.whl.
File metadata
- Download URL: sudodog-2.7.3-py3-none-any.whl
- Upload date:
- Size: 89.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5105d5dfcc15f0958d482f44f6ca93c5786ee83cb61589bb21964632722a5a99
|
|
| MD5 |
ae11b6464a3cc67034ac398da274825c
|
|
| BLAKE2b-256 |
c123af9f36a1b3d34e82a746ab15669f38a73a0d36eff66d81c645cb6c45ef3f
|