checking-system-logs ยท diff
git:20260223.16c1bd1 to git:20260323.e2d3bcc
8 added, 8 removed. Audit A to A.
---
name: checking-system-logs
description: "Use when finding bridge events, agent responses, timeouts, or errors in system logs. Triggered by requests to debug system behavior, investigate errors, or check what the agent did. Always filter by project name."
allowed-tools: Read, Grep, Glob, Bash
user-invocable: false
---
# System Logs
- **Location**: `/Users/valorengels/src/ai/logs/bridge.events.jsonl`
+ **Location**: `~/src/ai/logs/bridge.events.jsonl`
**IMPORTANT**: Always filter by project to get relevant results.
## Fields
- `project` - **required filter** ("DM", "Valor", "Django Project Template", etc.)
- `type` - event type (see below)
- `chat` - group name (null for DMs)
- `session_id` - e.g., "tg_dm_179144806"
- `sender` - who triggered the event
## Event Types
- `message_received` - incoming message
- `agent_request` - request sent to agent
- `agent_response` - Valor's response
- `agent_timeout` - response timed out
- `reply_sent` - message sent back to user
- `error` - system error
## Query Examples
```bash
# ALWAYS filter by project first, then by type or other criteria
# All recent events for a project
- grep '"project": "Valor"' /Users/valorengels/src/ai/logs/bridge.events.jsonl | tail -20 | jq .
+ grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | tail -20 | jq .
# Agent responses for a project
- grep '"project": "Valor"' /Users/valorengels/src/ai/logs/bridge.events.jsonl | grep '"type": "agent_response"' | tail -10 | jq .
+ grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep '"type": "agent_response"' | tail -10 | jq .
# Errors for a project
- grep '"project": "Valor"' /Users/valorengels/src/ai/logs/bridge.events.jsonl | grep '"type": "error"' | tail -10 | jq .
+ grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep '"type": "error"' | tail -10 | jq .
# Timeouts for a project
- grep '"project": "Valor"' /Users/valorengels/src/ai/logs/bridge.events.jsonl | grep '"type": "agent_timeout"' | tail -10 | jq .
+ grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep '"type": "agent_timeout"' | tail -10 | jq .
# Search keyword within a project
- grep '"project": "Valor"' /Users/valorengels/src/ai/logs/bridge.events.jsonl | grep -i "keyword" | tail -10 | jq .
+ grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep -i "keyword" | tail -10 | jq .
```
## List Available Projects
```bash
- grep -o '"project": "[^"]*"' /Users/valorengels/src/ai/logs/bridge.events.jsonl | sort -u
+ grep -o '"project": "[^"]*"' ~/src/ai/logs/bridge.events.jsonl | sort -u
```
## If No Results
If a project filter returns no results, list available projects and report them:
```bash
# No results? Check available projects:
- grep -o '"project": "[^"]*"' /Users/valorengels/src/ai/logs/bridge.events.jsonl | sort -u
+ grep -o '"project": "[^"]*"' ~/src/ai/logs/bridge.events.jsonl | sort -u
# Then retry with a valid project name from the list
```