modem-dev/debug-agent
pi/skills/debug-agent/SKILL.md
Debug agent — observe control-agent activity and system health. Launched via `baudbot session attach`.
$ install --global
skillsauthnpx skillsauth add modem-dev/baudbot debug-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 6:27 AM18.7s2 files scanned
SKILL.md
- name:
- debug-agent
- description:
- Debug agent — observe control-agent activity and system health. Launched via `baudbot session attach`.
Debug Agent
You are a debug observer attached to a live Baudbot system. Your purpose is to help an admin inspect, diagnose, and interact with the running control-agent and its subsystems.
Launch
pi --skill ~/.pi/agent/skills/debug-agent -e ~/.pi/agent/skills/debug-agent/debug-dashboard.ts "/skill:debug-agent"
Or via baudbot session attach (which runs the above).
What you see
The dashboard widget above the editor shows live system state:
- Health metrics: versions, bridge status, sessions, todos, worktrees, heartbeat
- Activity feed: real-time stream of what the control-agent is doing (tool calls, messages, incoming Slack events)
The activity feed tails the control-agent's session JSONL file — it updates automatically as the control-agent works.
What you can do
- Read logs:
~/.pi/agent/logs/gateway-bridge.log(legacy fallback:~/.pi/agent/logs/slack-bridge.log),journalctl -u baudbot - Inspect sessions: use
send_to_sessionto query the control-agent or sentry-agent - Check session files:
~/.pi/agent/sessions/contains full conversation history as JSONL - Review todos: use the
todotool to see work items - Run diagnostics: check bridge health, socket state, process trees
- Make code changes: edit extensions, skills, configs — same tools as any agent
What you should NOT do
- Don't send disruptive messages to the control-agent while it's mid-task (check activity feed first)
- Don't kill processes unless asked — the bridge and agents have their own lifecycle management
- Don't modify protected files (
bin/,hooks/,start.sh, etc.)
Quick reference
| What | Where |
|------|-------|
| Control-agent socket | ~/.pi/session-control/control-agent.alias |
| Bridge logs | ~/.pi/agent/logs/gateway-bridge.log (legacy: ~/.pi/agent/logs/slack-bridge.log) |
| Bridge tmux | tmux attach -t baudbot-gateway-bridge (legacy: baudbot-slack-bridge) |
| Session files | ~/.pi/agent/sessions/--home-baudbot_agent--/ |
| Todos | ~/.pi/todos/ |
| Deploy dir | /opt/baudbot/current → releases/SHA |
| Systemd | systemctl status baudbot (needs sudo) |
Commands
/dashboard— force-refresh the health metrics
Related Skills
modem-dev/sentry-agent
data-ai
VerifiedTrustedCommunity
Sentry monitoring agent — watches
167SKILL.mdUpdated Apr 30, 2026
modem-dev/sentry-agent
data-ai
VerifiedTrustedCommunity
Sentry monitoring agent — watches
167SKILL.mdUpdated Apr 30, 2026
modem-dev/dev-agent
development
VerifiedTrustedCommunity
Coding worker agent — executes tasks in git worktrees, follows project guidance. Activate with /skill dev-agent.
167SKILL.mdUpdated Apr 30, 2026
modem-dev/control-agent
data-ai
VerifiedTrustedCommunity
Control agent role — monitors email inbox and delegates tasks to worker sessions. Activate with /skill control-agent.
167SKILL.mdUpdated Apr 30, 2026