https://github.com/azzuwayed/switchboard-website
Switchboard — native macOS service manager
https://github.com/azzuwayed/switchboard-website
developer-tools macos service-manager
Last synced: 24 days ago
JSON representation
Switchboard — native macOS service manager
- Host: GitHub
- URL: https://github.com/azzuwayed/switchboard-website
- Owner: azzuwayed
- Created: 2026-05-24T16:44:48.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-10T12:09:45.000Z (29 days ago)
- Last Synced: 2026-06-10T13:17:58.757Z (29 days ago)
- Topics: developer-tools, macos, service-manager
- Language: HTML
- Homepage: https://azzuwayed.github.io/switchboard-website/
- Size: 9.41 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Switchboard by Azzuwayed
**The local service monitor for Mac developers.** One menu-bar app for forgotten dev servers, Homebrew services, Docker containers, launchd agents, HTTP endpoints, local AI tools, ports, and logs.
[**Download for macOS →**](https://azzuwayed.github.io/switchboard-website/) · [Changelog](https://github.com/azzuwayed/switchboard-website/releases) · [Support](https://github.com/azzuwayed/switchboard-website/issues)
---
## Why I built this app
I kept losing track of services I'd started. A dev server here, a database there, a tunnel for some experiment — half of them still running days later, none of them stopped, all of them quietly using CPU and battery I didn't have to spare. macOS doesn't tell you about this; Activity Monitor lists the processes but won't connect `node` to _the dev server I started last week_.
The problem got worse with AI coding agents. They're great at spinning up dev servers and not always great at stopping the previous one. Sometimes the agent is smart enough to free the port it needs; sometimes it just walks to the next available one. After a few hours of iteration you can end up with six copies of the same Vite server competing for memory, the laptop running hot, the battery draining fast, and nothing in macOS surfacing any of it.
There's another version of the problem: you build a service yourself and then forget where in your dev folders it lives. Or you're running a mix of local services and AI tooling — Claude Code, Ollama, LM Studio, [OpenClaw](https://github.com/openclaw/openclaw), your own Hermes dashboard, local LLM runtimes — each with its own log stream in its own corner of disk. Switchboard's unified Logs screen brings service logs and Switchboard activity into one timeline, with Switchboard Personal adding arbitrary manual files, so following what your local stack is doing doesn't require five terminal panes and a good memory.
Switchboard is the thing I wanted: one place where every local service shows up, every forgotten process gets surfaced, every port flood gets named with its actual cause, and every log stream lands on one screen.
## What it gives you
- **One tray for everything you run locally.** Start, stop, restart, and inspect Postgres, Redis, MySQL, MongoDB, Docker containers, your dev servers, and launchd agents from a single menu-bar icon.
- **A memory layer for the messy local machine.** Discovered, adopted, snoozed, ignored, resolved, and still-suspicious findings survive beyond one terminal session.
- **Port context Activity Monitor does not have.** Connect `node`, `python`, `docker`, or `ollama` to the service, port, logs, and safe next action.
- **Risk-aware actions.** Every command is allowlisted and explicitly approved before it runs. No arbitrary shell from the UI.
- **Local-first.** No background HTTP server. The only telemetry it sends is an anonymous active-install count over the update check — no identifiers, no raw IP stored, opt out in Settings → Privacy. Your config and logs live in `~/Library/Application Support/`.
- **Templates that actually work.** Postgres, MySQL, MongoDB, Redis, Docker Compose, Ollama, nginx, and more — reviewed and ready out of the box.
- **AI-agent setup help.** Switchboard Personal lets agents connect through MCP, run read-only guard checks, and create organized custom services from schemas and examples instead of ad-hoc shell commands.
## What's inside
- Service dashboard with running, degraded, stopped, and unknown states across every service kind.
- Health checks for Homebrew, Docker, HTTP, and command-backed services with live polling.
- Port inspector with conflict detection and service linking — no more `lsof`.
- Live log viewer for file and command-backed logs.
- Markdown docs viewer for your local runbooks.
- MCP integration for AI agents, including service inspection/control, docs lookup, guard reports, and custom-service creation helpers.
- First-run onboarding that detects what's already running on your machine.
## System requirements
macOS 12 (Monterey) or later on Apple Silicon or Intel Macs.
## Get it
→ [**azzuwayed.github.io/switchboard-website**](https://azzuwayed.github.io/switchboard-website/)
## Pricing
Switchboard stays useful for free: up to 5 active services, safe start/stop,
service command logs, recent Activity, a counts-only Observer teaser, basic
ports, service-down alerts, and new-arrival notifications. Fresh installs get a
7-day full-feature trial, then return to free use. A Switchboard Personal license ($39, with
promo codes from time to time) unlocks the rest — services beyond 5, full
Observer details and actions, Resources, manual log sources, full Activity,
diagnostics export, backup restore, config import/export, deeper port tools, and
the tray port console, plus MCP integration for AI agents — and activates up to 3 Macs. See
[pricing](https://azzuwayed.github.io/switchboard-website/pricing.html).
## Stay in the loop
- **Releases** — [Changelog](https://github.com/azzuwayed/switchboard-website/releases). The app also checks once a day and shows an in-app banner when a new release is available.
- **Bugs and ideas** — [Issues](https://github.com/azzuwayed/switchboard-website/issues).