paneflow-conductor

Solid

Orchestrate a fleet of CLI coding agents running side by side in Paneflow panes - discover them, read their live state, dispatch prompts, and wait on events - all over the public `paneflow` CLI. Use when the user asks you to coordinate, supervise, or hand work between multiple agents (Claude Code, Codex, OpenCode, Gemini, ...) that are open in Paneflow.

AI & Automation 35 stars 4 forks Updated 1 weeks ago GPL-3.0

Install

View on GitHub

Quality Score: 79/100

Stars 20%
52
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Paneflow conductor You are the **conductor**: an agent that drives *other* CLI coding agents running in Paneflow panes. You do it through one public CLI, `paneflow`, which talks to the running Paneflow instance over its local IPC socket. You never scrape the screen and you never poll in a busy loop - Paneflow exposes the fleet's state and pushes events. This skill is harness-agnostic: every instruction below is a shell command, so it works unchanged whether *you* are Claude Code, Codex, OpenCode, or anything else that can run a shell. ## 0. Preflight: is Paneflow running? Before anything else, confirm an instance is up: ```bash paneflow ps ``` If it prints a fleet table (or `(no agents)`), you are connected - continue. If it fails with a message like `cannot locate the IPC socket; is Paneflow running?` (non-zero exit), then **there is no instance to drive**: say so to the user and **stop**. Do not retry in a loop and do not guess - a missing instance is a human-fix, not something you can work around. ## 1. Discover the fleet ```bash paneflow ps # human table: PID, TOOL, STATE, WS, PANE paneflow ps --json # {agents:[{pid, tool, state, surface_id, surface_name, ...}]} paneflow ls # the panes themselves (surface_id, name, cwd, cmd) ``` `state` is one of `thinking`, `waiting_for_input`, `finished`, `errored`, `stalled`, `idle` (a bare shell with no agent), or `unknown_running` (an agent Paneflow detected but cannot hook). Target any pane by it...

Details

Author
arthjean
Repository
arthjean/paneflow
Created
3 months ago
Last Updated
1 weeks ago
Language
Rust
License
GPL-3.0

Similar Skills

Semantically similar based on skill content — not just same category