From devteam
Views DevTeam execution logs, event history, and debug info from SQLite database. Filters by session, agent, level, time; tails entries, exports JSON or file.
How this skill is triggered — by the user, by Claude, or both
Slash command
/devteam:devteam-logsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Session state: !`source "${CLAUDE_PLUGIN_ROOT}/scripts/state.sh" && get_current_session 2>/dev/null || echo "No active session"`
Session state: !source "${CLAUDE_PLUGIN_ROOT}/scripts/state.sh" && get_current_session 2>/dev/null || echo "No active session"
Recent events: !sqlite3 .devteam/devteam.db "SELECT type, message FROM events ORDER BY created_at DESC LIMIT 10" 2>/dev/null || echo "No events"
Command: /devteam:logs [options]
View execution logs, event history, and debugging information.
/devteam:logs # Show recent logs
/devteam:logs --session <id> # Show logs for specific session
/devteam:logs --agent <name> # Filter by agent
/devteam:logs --level error # Filter by log level
/devteam:logs --tail 50 # Show last 50 entries
/devteam:logs --export # Export logs to file
| Option | Description |
|---|---|
--session <id> | Filter by session ID |
--agent <name> | Filter by agent name |
--level <level> | Filter by level: debug, info, warn, error |
--tail <n> | Show last N entries (default: 20) |
--since <time> | Show logs since time (e.g., "1h", "30m") |
--export | Export to logs/devteam-TIMESTAMP.log |
--json | Output as JSON |
--verbose | Show full log details |
async function getLogs(options) {
let query = `
SELECT
e.id,
e.timestamp,
e.event_type,
e.data,
s.command as session_command,
ar.agent
FROM events e
LEFT JOIN sessions s ON e.session_id = s.id
LEFT JOIN agent_runs ar ON e.session_id = ar.session_id
WHERE 1=1
`
const params = []
if (options.session) {
query += ` AND e.session_id = ?`
params.push(options.session)
}
if (options.agent) {
query += ` AND ar.agent LIKE ?`
params.push(`%${options.agent}%`)
}
if (options.level) {
query += ` AND json_extract(e.data, '$.level') = ?`
params.push(options.level)
}
if (options.since) {
const sinceTime = parseTimeOffset(options.since)
query += ` AND e.timestamp > datetime('now', ?)`
params.push(sinceTime)
}
query += ` ORDER BY e.timestamp DESC LIMIT ?`
params.push(options.tail || 20)
return await db.all(query, params)
}
Default Output:
DevTeam Logs
Showing last 20 entries
2026-01-29 10:45:23 [INFO] session_started
Command: /devteam:implement --sprint 1
Session: sess_abc123
2026-01-29 10:45:25 [INFO] agent_started
Agent: backend:api-developer-typescript
Task: TASK-001
Model: sonnet
2026-01-29 10:46:15 [INFO] gate_passed
Gate: tests
Duration: 12s
2026-01-29 10:46:18 [WARN] gate_failed
Gate: lint
Errors: 3
Details: src/api.ts:45 - Missing semicolon
2026-01-29 10:46:45 [INFO] fix_applied
Issue: lint errors
Files: ["src/api.ts"]
2026-01-29 10:47:02 [INFO] gate_passed
Gate: lint
Duration: 8s
2026-01-29 10:47:30 [INFO] task_completed
Task: TASK-001
Iterations: 2
Model: sonnet
2026-01-29 10:47:32 [INFO] session_ended
Status: completed
Duration: 2m 9s
Cost: $0.12
Filter: /devteam:logs --level error
Export: /devteam:logs --export
Error Filter:
/devteam:logs --level error --since 24h
DevTeam Logs - Errors (last 24h)
2026-01-29 09:15:42 [ERROR] agent_failed
Agent: database:developer-python
Task: TASK-003
Error: Migration failed - column already exists
Stack: alembic/operations.py:123
migrations/versions/abc123.py:45
2026-01-28 16:22:18 [ERROR] gate_failed
Gate: tests
Failures: 2
Details:
- test_user_creation: AssertionError
- test_login_flow: TimeoutError
Total errors: 2
Sessions affected: 2
Session Detail:
/devteam:logs --session sess_abc123 --verbose
Session: sess_abc123
Command: /devteam:implement --sprint 1
Status: completed
Timeline
10:45:23.123 session_started
10:45:23.456 phase_changed -> initializing
10:45:24.789 agent_started -> backend:api-developer-typescript
10:45:25.012 phase_changed -> executing
10:45:45.234 tool_call -> Edit (src/api.ts)
10:46:02.456 tool_call -> Bash (npm test)
10:46:15.678 gate_passed -> tests (12s)
10:46:16.890 tool_call -> Bash (npm run lint)
10:46:18.123 gate_failed -> lint (3 errors)
10:46:20.456 fix_task_created -> lint_errors
10:46:45.789 fix_applied -> lint_errors
10:47:02.012 gate_passed -> lint (8s)
10:47:30.234 task_completed -> TASK-001
10:47:32.456 session_ended -> completed
Agents Used
backend:api-developer-typescript | 1m 45s | sonnet | $0.10
lint-fixer | 25s | haiku | $0.02
Quality Gates
tests: passed (12s)
lint: passed (retry after fix)
typecheck: passed (5s)
Tokens
Input: 15,234 tokens
Output: 3,456 tokens
Cost: $0.12
/devteam:logs --export --since 7d
Creates: logs/devteam-2026-01-29T104500.log
# DevTeam Execution Log
# Exported: 2026-01-29T10:45:00Z
# Filter: since 7d
# Entries: 156
[2026-01-29T10:45:23.123Z] INFO session_started session_id=sess_abc123 command="/devteam:implement --sprint 1"
[2026-01-29T10:45:25.012Z] INFO agent_started agent=backend:api-developer-typescript model=sonnet task=TASK-001
...
| Level | Description |
|---|---|
debug | Detailed debugging information |
info | General execution information |
warn | Warnings that don't stop execution |
error | Errors that may impact execution |
/devteam:status - System status and metrics/devteam:status --history - Session historynpx claudepluginhub michael-harris/devteam --plugin devteamDisplays DevTeam session status, sprint/task progress, model usage costs, agent metrics, quality gates, escalations, and execution history. Ideal for monitoring agent-based dev workflows.
Inspects and queries Claude Code hook event logs from .claude/logs JSONL files. Subcommands list sessions, timelines, tool traces, agent lifecycles, team activity, stats, coverage, and daily summaries.
Queries and analyzes JSONL agent event logs to debug behavior, find slow tool calls, trace decisions, and summarize session performance.