debug

Solid

Debug container agent issues. Use when things aren't working, container fails, authentication problems, or to understand how the container system works. Covers logs, environment variables, mounts, and common issues.

AI & Automation 48 stars 3 forks Updated today MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
56
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Deus Container Debugging This guide covers debugging the containerized agent execution system. ## Architecture Overview ``` Host (macOS) Container (Linux VM) ───────────────────────────────────────────────────────────── src/container-runner.ts container/agent-runner/ │ │ │ spawns container │ runs Claude Agent SDK │ with volume mounts │ with MCP servers │ │ ├── data/env/env ──────────────> /workspace/env-dir/env ├── groups/{folder} ───────────> /workspace/group ├── data/ipc/{folder} ────────> /workspace/ipc ├── data/sessions/{folder}/.claude/ ──> /home/node/.claude/ (isolated per-group) └── (main only) project root ──> /workspace/project ``` **Important:** The container runs as user `node` with `HOME=/home/node`. Session files must be mounted to `/home/node/.claude/` (not `/root/.claude/`) for session resumption to work. ## Log Locations | Log | Location | Content | |-----|----------|---------| | **Main app logs** | `logs/deus.log` | Host-side WhatsApp, routing, container spawning | | **Main app errors** | `logs/deus.error.log` | Host-side errors | | **Container run logs** | `groups/{folder}/logs/container-*.log` | Per-run: input, mounts, stderr, stdout | | **Claude sessions** | `~/.claude/projects/` | Claude Code session history | ## Enabling Debug Logging Set `LOG_LEVEL=debug` for...

Details

Author
sliamh11
Repository
sliamh11/Deus
Created
4 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Docker · Infrastructure Model Context Protocol · AI

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

debug

Debug container agent issues. Use when things aren't working, container fails, authentication problems, or to understand how the container system works. Covers logs, session DBs, mounts, and common issues.

30,388 Updated today
nanocoai
AI & Automation Solid

claudette-debug

Debug the running Claudette Tauri app by executing JavaScript in the webview and reading results back. Inspect Zustand store state, trace state changes, monitor sessions long-term, run end-to-end UAT, and diagnose UI bugs in real-time. Only works in dev builds.

61 Updated today
utensils
Data & Documents Listed

cm-debug

End-to-end data pipeline debugger for claude-monitor. Traces data from raw JSONL transcripts through SQLite ingestion to API responses to frontend rendering. Use this skill whenever the user reports a data issue, missing session, wrong token counts, broken chart, missing events, agent tree problems, or any discrepancy between what's in the transcript and what's shown in the dashboard. Also trigger when the user says things like "why isn't X showing", "the data looks wrong", "session is missing", "tokens don't match", "chart is broken", "events aren't appearing", "reimport didn't work", or wants to inspect how a specific JSONL file was processed. Covers the full pipeline: JSONL parsing, event extraction, token tracking, DB storage, API retrieval, and Playwright-based UI verification.

12 Updated today
pigorv