minion-orchestrator

Route durable background work between shell jobs and LLM subagent runs via a Postgres-backed queue.

Updated May 11, 2026
One-click install
npx skills add https://github.com/yunusgungor/gbrain --skill minion-orchestrator-yunusgungor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minion-orchestrator
Source: https://github.com/yunusgungor/gbrain/tree/main/skills/minion-orchestrator
Command: npx skills add https://github.com/yunusgungor/gbrain --skill minion-orchestrator-yunusgungor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating long-running automated tasks across two execution lanes—reliable shell jobs and open-ended subagent work—without losing state or visibility.

Core Features & Use Cases

  • Single durable, observable queue that supports both deterministic shell tasks and LLM-driven subagents.
  • Progress tracking, steering, pausing/resuming, and parallel fan-out with DAGs.
  • Postgres-backed persistence ensures durability across restarts and clear routing policies.

Quick Start

Create and run a minion workflow by submitting a shell job or a subagent task with the gbrain CLI.

Frequently Asked Questions about minion-orchestrator

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

FAQPage Schema
How do I coordinate long-running shell jobs and LLM subagent tasks without losing state?

You can coordinate long-running shell jobs and LLM subagent tasks using a Postgres-backed durable queue that ensures state persistence and clear routing policies across restarts. This provides a single observable queue for both execution lanes.

What is the best way to track progress and pause background workflows?

The best way to track progress and pause background workflows is to use an orchestrator that supports steering, pausing, resuming, and progress tracking for both deterministic shell tasks and open-ended subagent runs.

How do I submit and monitor parallel subagent work in a fan-out scenario?

To submit and monitor parallel subagent work in a fan-out scenario, you route tasks through a durable queue that supports DAGs and parallel fan-out, allowing you to monitor execution across multiple flows simultaneously.

Do I need Postgres to ensure durability for background job queues?

Yes, you need Postgres to ensure durability for background job queues, as it provides the persistence layer required to maintain state and visibility for shell and subagent tasks across system restarts.

Can I route deterministic shell commands and open-ended LLM runs through the same queue?

Yes, you can route deterministic shell commands and open-ended LLM runs through the same queue. The orchestrator enforces safe routing policies to handle both execution lanes within a single durable workflow.