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.6.tar.gz
(75.3 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.6-py3-none-any.whl
(89.4 kB
view details)
File details
Details for the file sudodog-2.7.6.tar.gz.
File metadata
- Download URL: sudodog-2.7.6.tar.gz
- Upload date:
- Size: 75.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a13829a4be3e2b4fafbd28a8981edd785b9445997f8954bf92124338fc5bf667
|
|
| MD5 |
7b118d3bc74b415a94627af045d222d5
|
|
| BLAKE2b-256 |
8ce0d039801abb9ebd6869bf9a256452dcbdb775412af99b766a0dc819189747
|
File details
Details for the file sudodog-2.7.6-py3-none-any.whl.
File metadata
- Download URL: sudodog-2.7.6-py3-none-any.whl
- Upload date:
- Size: 89.4 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 |
331b6b28d56ae6e923c00bc9f8456ed77ba525717f0c8c76c8ca15689cddfcea
|
|
| MD5 |
013f5f6c66017c5506c76930447e8fb8
|
|
| BLAKE2b-256 |
d6a3f77d65ac4b6393811d2c2c6cb0423e3b55939e17b0df95676e5a72d3adf7
|