| name | deploy |
| description | Deploy a Sapphire service locally or check its status |
| disable-model-invocation | true |
/deploy — Sapphire Service Deployment
Deploy or restart a Sapphire service. All services run on Mac with LaunchAgents.
Usage
/deploy <service> # Start/restart the service
/deploy <service> status # Check if running
/deploy all status # Check all services
Services
| Service | Port | LaunchAgent |
|---|
| control-plane | 8082 | com.sapphire.control-plane |
| dashboard | 8080 | com.sapphire.dashboard |
| signal-logger | 18081 | com.sapphire.signal-logger |
| telegram-bot | — | com.sapphire.nemotron-bot |
| openbb | 6900 | com.sapphire.openbb-api |
| redis | 6379 | homebrew.mxcl.redis |
How to Deploy
- Check if the service is running:
curl -s http://127.0.0.1:<port>/health
- If down, restart via LaunchAgent:
launchctl kickstart -k gui/$(id -u)/<launchagent>
- Verify it's back: retry the health check
- Log deployment event to
data/system_events.jsonl
Windows Services (via SSH)
| Service | Port | Scheduled Task |
|---|
| ollama | 11434 | OllamaTailscale |
| webhook | 9090 | SapphireWebhook |
Restart via: ssh workbench "powershell -Command Start-ScheduledTask -TaskName '<task>'"
Pre-deploy Checks
Before deploying, always:
- Run
ruff check on the service directory
- Run related tests:
python3 -m pytest tests/unit/ -q --tb=no
- Check for uncommitted changes:
git status --short
