check-experiments

What problem does it solve?

Rapidly discover the status, progress, and failures of ML experiments running inside tmux sessions so you can understand resource usage and experiment health without attaching or altering processes.

Core Features & Use Cases

• Session discovery: Enumerates tmux sessions and reports name, creation time, and attach/detach status.
• Progress parsing: Extracts epoch/step counts, percentages, loss and metric values, and ETA from recent terminal output.
• Log inspection & error detection: Reads recent CSV/log rows and scans for common failure patterns like CUDA OOM and Python Tracebacks; ideal for multi-GPU training sweeps, ablation studies, and resumptions.
• Status reporting: Produces a concise table summarizing status, progress, key metric, and ETA for easy sharing or documentation.

Quick Start

Run a tmux session scan, parse the last outputs and recent CSV logs, and return a concise status report of all experiments.