minion-orchestrator

Orchestrate durable background shell and LLM subagent jobs with Postgres persistence.

2|1|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/bish-x/bx-gbrain --skill minion-orchestrator-bish-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minion-orchestrator
Source: https://github.com/bish-x/bx-gbrain/tree/main/skills/minion-orchestrator
Command: npx skills add https://github.com/bish-x/bx-gbrain --skill minion-orchestrator-bish-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Minion Orchestrator unifies deterministic shell jobs and LLM subagent orchestration, providing a durable and observable queue for background work that needs to survive restarts and persist across sessions.

Core Features & Use Cases

  • Unified Queue Interface: Handle both deterministic shell jobs and LLM subagent jobs in one queue.
  • Job Persistence: Jobs survive gateway restarts using Postgres.
  • Job Monitoring: Track progress, send messages to steer agents, and manage job lifecycle.
  • Use Case: For a research project that involves running shell scripts for data processing and simultaneously orchestrating multiple LLM agents for reasoning tasks.

Quick Start

Submit a shell job using Minion Orchestrator with the command gbrain jobs submit shell --params '{"cmd":"echo hello","cwd":"/abs/path"}'.

Frequently Asked Questions about minion-orchestrator

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

FAQPage Schema
How do I orchestrate background jobs for both shell commands and LLM subagents?

You can orchestrate background jobs for shell commands and LLM subagents by submitting them to a unified queue interface. This allows you to manage deterministic scripts and LLM reasoning tasks together, tracking their progress and lifecycle in one place.

How do I persist background jobs to survive gateway restarts?

To persist background jobs and survive gateway restarts, you need to use Postgres. The orchestrator uses Postgres to store job state, ensuring that both shell and LLM subagent work resumes reliably across sessions and unexpected interruptions.

Can I monitor and steer an LLM subagent while it is running?

Yes, you can monitor and steer an LLM subagent during execution. The orchestrator provides job monitoring capabilities that allow you to track progress, send messages to steer agents dynamically, and manage the overall job lifecycle.

What is the best way to manage durable background work for data processing and LLM reasoning?

The best way to manage durable background work for data processing and LLM reasoning is using a unified queue interface. It combines deterministic shell job execution with LLM subagent orchestration, providing observable and steerable job management.

How do I submit a shell job to a background queue using the command line?

You submit a shell job to the background queue by executing a CLI command with specific parameters. Provide the command string and working directory in a JSON payload, such as passing the cmd and cwd arguments to the job submission script.