Switchyard

CLI node process manager + macOS menubar app. Track, label, kill, and restart your dev servers. Ward is watching.

What is Switchyard?

Switchyard is a companion tool for managing your dev servers. It detects every running node process, lets you label and group them, and provides health monitoring — all from a single sy command or the Ward menubar app.

Built as part of the Kindling Signal ecosystem alongside TaskJunky.

Why use it with TaskJunky?

When your AI assistant launches dev servers via sy run, Switchyard automatically tracks them. Combined with TaskJunky's Claude Code hooks, every process your AI starts gets labeled and monitored — no manual tracking needed.

TaskJunky manages what you're building (tasks, plans, activity)
Switchyard manages what's running (processes, ports, health)

Install

git clone https://github.com/mkteagle/switchyard.git
cd switchyard
pnpm install && pnpm build
pnpm link --global

Verify: sy --version

Quick start

sy                    # List all running node processes
sy run                # Launch dev server from package.json
sy run --detach       # Launch in background
sy kill :3000         # Kill process on port 3000
sy health             # Health check registered processes
sy watch              # Live-updating table

Menubar app

Native macOS menubar app (SwiftUI, macOS 14+). Build and run:

cd app
xcodegen generate
open Switchyard.xcodeproj
# Build and Run (⌘R)

The Ward owl icon appears in your menubar. Click it for a live process dashboard with kill, restart, logs, and group management.

Next steps

CLI Reference — all 17 commands
Configuration — project and global settings
Menubar App — features and setup