Skill

symphony-daemon

Sets up and manages macOS launchd daemon for Symphony task orchestration in repos with orchestration/symphony_overlay/daemon. Enqueues benchmark plugins like leetcode_hard and swe-bench.

Bash

Python

Elixir

devops

automation

Install

npx claudepluginhub jleechanorg/claude-commands

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Use this skill in repos that vendor `orchestration/symphony_overlay/daemon/*`.

SKILL.md

Similar Skills

kotlin-ktor-patterns

Provides Ktor server patterns for routing DSL, plugins (auth, CORS, serialization), Koin DI, WebSockets, services, and testApplication testing.

everything-claude-code

163.2k

deep-research

Conducts multi-source web research with firecrawl and exa MCPs: searches, scrapes pages, synthesizes cited reports. For deep dives, competitive analysis, tech evaluations, or due diligence.

everything-claude-code

163.2k

inventory-demand-planning

Provides demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation for multi-location retailers managing 300-800 SKUs.

everything-claude-code

163.2k

Stats

Stars26

Forks4

Last CommitMar 24, 2026

Actions

View Source View Plugin View on GitHub View README

Symphony Daemon (Portable Pattern)

Use this skill in repos that vendor orchestration/symphony_overlay/daemon/*.

Platform Scope

This workflow is macOS-only (uses launchd / launchctl).

Variables

Set these at the start of every run:

REPO_ROOT: absolute path to target repo (defaults to current directory)
SYMPHONY_ELIXIR_DIR: absolute path to local symphony/elixir
PLUGIN: plugin id from orchestration/symphony_overlay/daemon/plugins
PLUGIN_INPUT: plugin input path (absolute, or relative to REPO_ROOT)

export REPO_ROOT="${REPO_ROOT:-$(pwd)}"
export SYMPHONY_ELIXIR_DIR="${SYMPHONY_ELIXIR_DIR:-$HOME/projects_reference/symphony/elixir}"
export PLUGIN="${PLUGIN:-leetcode_hard}"
export PLUGIN_INPUT="${PLUGIN_INPUT:-benchmarks/harness/leetcode_hard_5_alt.json}"

if [[ -f "$PLUGIN_INPUT" ]]; then
  export PLUGIN_INPUT_PATH="$PLUGIN_INPUT"
else
  export PLUGIN_INPUT_PATH="$REPO_ROOT/$PLUGIN_INPUT"
fi

Preconditions

python3, jq, launchctl are available.
SYMPHONY_ELIXIR_DIR exists.
Repo contains orchestration/symphony_overlay/daemon/.
Plugin input exists.

Quick validation:

test "$(uname -s)" = "Darwin" || { echo "This skill requires macOS launchd"; exit 1; }
test -d "$SYMPHONY_ELIXIR_DIR" || { echo "Missing SYMPHONY_ELIXIR_DIR"; exit 1; }
test -f "$REPO_ROOT/orchestration/symphony_overlay/daemon/setup_launchd_daemon.py" || { echo "Missing setup script"; exit 1; }
test -f "$PLUGIN_INPUT_PATH" || { echo "Missing plugin input: $PLUGIN_INPUT_PATH"; exit 1; }

Install or Update Daemon

cd "$REPO_ROOT"
SYMPHONY_TASK_PLUGIN="$PLUGIN" \
SYMPHONY_TASK_PLUGIN_INPUT="$PLUGIN_INPUT_PATH" \
SYMPHONY_ELIXIR_DIR="$SYMPHONY_ELIXIR_DIR" \
python3 orchestration/symphony_overlay/daemon/setup_launchd_daemon.py

Enqueue Tasks

cd "$REPO_ROOT"
SYMPHONY_TASK_PLUGIN="$PLUGIN" \
SYMPHONY_TASK_PLUGIN_INPUT="$PLUGIN_INPUT_PATH" \
"$REPO_ROOT/orchestration/symphony_overlay/daemon/enqueue_plugin_tasks.sh"

Switch Plugin/Input Without Reinstall

cd "$REPO_ROOT"
SYMPHONY_TASK_PLUGIN="swe_bench_verified" \
SYMPHONY_TASK_PLUGIN_INPUT="$REPO_ROOT/benchmarks/harness/swe_bench_verified_5.json" \
"$REPO_ROOT/orchestration/symphony_overlay/daemon/enqueue_plugin_tasks.sh"

Troubleshooting

Daemon not receiving tasks:
- rerun setup_launchd_daemon.py
- check metadata exists and has expected values:

cat "$HOME/Library/Application Support/orchestrator_benchmark/symphony_daemon/daemon_metadata.json"

Plugin import errors:
- confirm plugin exists under daemon/plugins
- run plugin tests:

cd "$REPO_ROOT"
python3 -m pytest -q orchestration/symphony_overlay/daemon/tests/test_plugins.py

Fairness and Isolation (Benchmark Use)

Use per-orchestrator /tmp directories.
Use unique port ranges per orchestrator.
Keep task specs/acceptance criteria identical across orchestrators.
End each attempt with either benchmark_commit or machine-readable blocked_reason.