background-tasks

What problem does it solve?

Automates the execution and monitoring of background tasks to prevent context pollution from long-running processes during debugging, tests, builds, and dev servers.

Core Features & Use Cases

• bg_run to start a command in the background and obtain a task ID
• bg_status to list all tasks or check a specific task's status
• bg_output for smart, context-safe log reading with filters, excludes, and incremental reads
• bg_stop to kill a running task or clean up finished task records
• Guidance on using log hygiene rules (filters, since, tail, max_lines) for clean context
• Monorepo workflows: coordinate backend and frontend tasks and read targeted logs

Quick Start

Start a background task with bg_run and then monitor its output with bg_output using appropriate filters.