What problem does it solve?
This Skill removes the pain of losing long-running local shell work to session timeouts, compaction, or one-shot command limits. It gives you a durable way to launch, inspect, stop, and resume repo-local background jobs.
Core Features & Use Cases
- Detached job launch: Start a command in the background and keep its state on disk.
- Live monitoring: Check job status, process state, timestamps, and recent logs.
- Stop and recover: Terminate jobs cleanly or forcefully, then resume interrupted or finished work later.
- Session-aware tracking: Tie jobs to an OpenCode session alias and recover them after context loss.
- Use case: Helpful for builds, releases, maintenance scripts, and other non-GPU tasks that may outlive a single shell call.
Quick Start
Ask the AI to launch my long-running local shell command as a background job and keep it monitorable, using the bgshell-job workflow.