/devteam-logs

name: devteam-logs
description: View execution logs, event history, and debugging information.
argument-hint: [--session <id>] [--agent <name>] [--level <debug|info|warn|error>] [--tail <n>] [--export] [--json]
user-invocable: true
allowed-tools: Read, Glob, Grep, Bash
model: haiku

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"`

DevTeam Logs Command

**Command:** `/devteam:logs [options]`

View execution logs, event history, and debugging information.

Usage

/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

Options

| 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 |

Your Process

Step 1: Query Events Database

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)
}

Step 2: Display Logs

**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

Step 3: Export Logs

/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
...

Log Levels

| Level | Description | |-------|-------------| | `debug` | Detailed debugging information | | `info` | General execution information | | `warn` | Warnings that don't stop execution | | `error` | Errors that may impact execution |

See Also

• `/devteam:status` - System status and metrics
• `/devteam:status --history` - Session history