async-task-runner

Manage long-running background processes with monitoring and graceful termination in Linux.

Updated May 5, 2026
One-click install
npx skills add https://github.com/iani-kuli/harness_bro --skill async-task-runner-iani-kuli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: async-task-runner
Source: https://github.com/iani-kuli/harness_bro/tree/main/.claude/skills/curated/async-task-runner
Command: npx skills add https://github.com/iani-kuli/harness_bro --skill async-task-runner-iani-kuli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the issue of blocking your interactive chat session with long-running processes like model training, evaluation, or batch data processing.

Core Features & Use Cases

  • Background Execution: Safely launches processes using nohup or tmux to ensure they persist after the session ends.
  • Process Monitoring: Provides standardized helpers to track logs, CPU/memory usage, and disk space for active tasks.
  • Graceful Lifecycle Management: Includes commands to safely stop processes without causing state corruption or data loss.

Quick Start

Use the async task runner to start a training script in the background and monitor its output log.

Frequently Asked Questions about async-task-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run long-running background processes without blocking my interactive session?

Run long-running background processes without blocking your interactive session by launching them with nohup or tmux. This ensures task persistence after the session ends, allowing you to continue working while jobs execute in the background.

How do I monitor CPU and memory usage for active background jobs?

Monitor CPU and memory usage for active background jobs using standardized process tracking helpers. The system tracks logs, resource consumption, and disk space to provide visibility into running tasks.

What is the best way to stop a running background task without causing data loss?

The best way to stop a running background task without data loss is through graceful lifecycle management. This safely terminates processes using PID tracking to prevent state corruption during shutdown.

Does this background process runner work in a Linux environment?

Yes, this background process runner works in a Linux environment. It implements standardized directory structures and PID tracking to facilitate process monitoring and ensure task persistence specifically within Linux systems.

Why do my background training jobs terminate when the chat session ends?

Background training jobs terminate when the chat session ends because they lack process persistence. Launching jobs using nohup or tmux ensures they continue running independently of the originating session's lifecycle.