SlayNode

A Tahoe-native macOS control room for local services

SlayNode gives you one place to discover, inspect, and control local services on modern macOS. It unifies live development runtimes, Docker containers, and Homebrew Services into one native dashboard with a fast menu bar entry point, workspace-aware search, and deliberate control actions.

What You Can Do

• Discover local processes, Docker containers, and Homebrew Services automatically
• Inspect ports, runtime/source, workspace ownership, command context, and health
• Use Stop, Force Stop, Restart, Open Logs, and Open Workspace when supported
• Search across services, ports, runtimes, and workspaces from the native toolbar
• Restore recent workspaces and window context through local on-device persistence
• Keep everything local on your Mac without sending service metadata anywhere

Install

1. Download the latest release from GitHub Releases.

2. Drag SlayNode.app into /Applications.

3. Launch it:

   open /Applications/SlayNode.app

Build From Source

Requirements

• macOS 26.0 or later
• Xcode 26 or current Command Line Tools with Swift 6.2 support

git clone https://github.com/mastertyko/slaynode.git
cd slaynode
./script/build_and_run.sh

Run the test suite with:

swift test

Using SlayNode

1. Launch the app and let the dashboard refresh.
2. Choose All Services or focus a workspace from the sidebar.
3. Select a service from the center column to inspect it in the detail view and inspector.
4. Use Stop, Force Stop, Restart, Logs, or Open Workspace depending on what the source supports.
5. Use Cmd+, for Settings, the toolbar search field to narrow the list, and the app menu for About.

Recognition Model

• Frameworks like Vite, Next.js, Bun, Deno, Python, Ruby, and Go services are normalized into one service model.
• Docker containers and Homebrew Services are first-class sources with source-specific actions.
• Working directory, command parsing, ports, health, and dependency heuristics are combined to reduce false positives.
• Sensitive arguments such as API keys and tokens are redacted before commands are shown in the UI.

Product Shape

• Main window: Tahoe-native NavigationSplitView with sidebar, list, detail, and inspector
• Menu bar: fast triage surface backed by the same service graph as the main app
• Persistence: recent workspaces, actions, and window state stored locally with SwiftData
• System integration: App Intents, Spotlight indexing, local notifications, and native window restoration

Documentation

• INSTALL.md for installation, source-build, and troubleshooting
• docs/DEVELOPMENT.md for architecture, release automation, and contributor context
• docs/ICON_SYSTEM.md for the brand asset pipeline

License

This project is licensed under the MIT License. See the LICENSE file for details.