← ClaudeAtlas

checking-system-logslisted

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.
tomcounsell/ai · ★ 14 · AI & Automation · score 71
Install: claude install-skill tomcounsell/ai
# System Logs **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"' ~/src/ai/logs/bridge.events.jsonl | tail -20 | jq . # Agent responses for a project grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep '"type": "agent_response"' | tail -10 | jq . # Errors for a project grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep '"type": "error"' | tail -10 | jq . # Timeouts for a project grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep '"type": "agent_timeout"' | tail -10 | jq . # Search keyword within a project grep '"project": "Valor"' ~/src/ai/logs/bridge.events.jsonl | grep -i "keyword" | tail -10 | jq . ``` ## List Available Projects ```bash grep -o '"project": "[^"]*"' ~/src/ai/logs/bridge.events.jsonl | sort -u ``` ## If No Resul