skills.rest
PeterHiroshi
PeterHiroshiCOMMUNITY
Explore all skills by this author →
GitHub

bg-dispatch

Dispatch long-running coding agents to background tasks with resumable progress.

3|Updated Mar 20, 2026
Search Tags:#automation#notifications#resume#adapters#background-dispatch#bg-dispatch
One-click install
npx skills add https://github.com/PeterHiroshi/bg-dispatch --skill bg-dispatch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bg-dispatch
Source: https://github.com/PeterHiroshi/bg-dispatch/tree/main
Command: npx skills add https://github.com/PeterHiroshi/bg-dispatch --skill bg-dispatch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

bg-dispatch addresses the challenge of long-running coding tasks by decoupling the execution from the main chat session, enabling background agents to run without blocking user interaction.

Core Features & Use Cases

  • Pluggable adapters (claude-code, aider, codex) to run background tasks.
  • Centralized progress tracking and resumability across container resets.
  • Notification pathways (OpenClaw wake, webhooks, or custom commands) on completion.

Quick Start

Install bg-dispatch, configure bg-dispatch.json, and dispatch a task.

Frequently Asked Questions about bg-dispatch

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

FAQPage Schema
How do I run long coding tasks in the background without blocking my main session?▼

Background dispatch decouples long-running coding agent execution from your main chat session using a fire-and-forget model. This keeps the main session responsive while centralized progress tracking monitors the background task.

Can I use background dispatch with Claude Code, Aider, or Codex CLI?▼

Background dispatch supports pluggable adapters for Claude Code, Aider, and Codex CLI. These adapters enable you to run background tasks across different long-running coding tools without blocking user interaction.

How do I get notified when a long-running background agent finishes?▼

Background dispatch notifies on completion via pluggable notifiers, including OpenClaw wake, webhooks, or custom commands. You can configure these notification pathways to receive alerts when your background tasks complete.

Can I resume a background coding task after an interruption or container reset?▼

Background dispatch supports resume after interruptions through centralized progress tracking. It maintains task state across container resets, allowing you to resume long-running background agents exactly where they stopped.

What's the best way to configure fire-and-forget dispatch for long-running agents?▼

To configure fire-and-forget dispatch, install bg-dispatch and set up bg-dispatch.json with your desired adapters and notification pathways. This configuration centralizes progress tracking and enables background execution for long tasks.

Why does my coding agent block the main session during long tasks?▼

Long-running coding agents block the main session because execution is coupled to the active chat. Background dispatch solves this by decoupling execution into a fire-and-forget model, enabling background agents to run independently.

Related Skills

Explore More Software Engineering Skills→
yuhle-qugyuhle-qug

database-expert

Analyze and optimize database performance across PostgreSQL, MySQL, MongoDB, and SQLite.

Community
Advanced
SufficientDaikonSufficientDaikon
8

async-side-effects

Design non-blocking side effect pipelines with Promise.allSettled and AbortSignal timeouts.

Community
Advanced
breakingcircuits1337breakingcircuits1337

coding-agent

Automate coding agents like Codex CLI and Claude Code in background tasks.

Community
Advanced
ShinyGuaShinyGua

mm-progress-monitor

Monitor status.json and update TodoWrite checklists in real time.

Community
Intermediate