Logging

Every sandbox writes its output to plain-text log files on disk. You can view, stream, and download these logs through the CLI, the dashboard, or the MCP plugin.

Log Storage

Logs are stored per-sandbox at:

~/.stackie/storage/logs/{sandbox_id}/
  stdout.log   # standard output
  stderr.log   # standard error

Log files are newline-delimited plain text. They are never rotated during a sandbox’s lifetime but are removed when the sandbox is destroyed.

Viewing Logs

# Stream live logs for a running sandbox
stackie logs <sandbox>

# Show the last 50 lines
stackie logs <sandbox> --tail 50

# Follow log output in real time
stackie logs <sandbox> --follow

Error Detection

Stackie automatically scans log output for error patterns and classifies lines by severity (info, warning, error, fatal). Errors surfaced in the dashboard and CLI originate from this analysis.