jam-runtime-logs

What problem does it solve?

Always preserve logs for long-running Jam dev servers and backend-like processes so failures can be diagnosed after the fact. Use the scratch/ directory to store these logs and share them with teammates.

Core Features & Use Cases

• Foreground log capture: start a process and stream logs into scratch/logs for immediate visibility.
• Background process management: run services detached from the terminal with log retention for later analysis.
• Inspect, stop, and verify: quickly view recent log output and terminate processes by PID when needed.
• Port-awareness: detect port conflicts and identify the owning process before retrying.
• Handoff readiness: record paths and relevant error lines in workpads or PR notes for sharing context.

Quick Start

Start a long-running Jam process and automatically capture its logs to scratch/logs for later inspection.