Supervisor Control

This section documents the supervisor control CLI exposed through:

yarn ctl <command> [args]

The yarn ctl script routes to @isomorphiq/supervisor control and talks to the supervisor control API (default: http://127.0.0.1:3014).

You can optionally include a separator:

yarn ctl -- <command> [args]

Quick Start

Check control plane health:

yarn ctl health

List managed processes:

yarn ctl ps

Restart a service:

yarn ctl restart gateway

Stream recent diagnostics events from JetStream:

yarn ctl logs

Commands Reference

Full command reference and options:

• Supervisor Commands

Process Targets

yarn ctl commands that operate on processes (start, stop, restart, status) accept:

• A service process id, for example gateway
• A worker target in worker@<worker-id> form, for example worker@worker-1

Common service ids:

• auth-service
• profiles-service
• artifacts-service
• search-service
• context-service
• moac-service
• notifications-service
• dashboard-service
• workflows-service
• task-service
• ontology-service
• gateway
• federation-modules-dev
• appshell-ssr
• edge-proxy
• worker-manager
• mcp-service
• supervisor-control (control API pseudo-process)

Notes

• logs tails every *.log file under repository ./logs, including worker logs like worker-1.log.
• start and restart wait for health by default.
• stop accepts an optional signal; default behavior is graceful shutdown (SIGTERM).