Skip to content

vandelay daemon

Install and manage the background daemon for 24/7 operation.

Usage

vandelay daemon <subcommand>

Subcommands

install

Install the daemon as a system service:

vandelay daemon install
  • Linux: Creates a systemd user unit (~/.config/systemd/user/vandelay.service)
  • macOS: Creates a launchd plist (~/Library/LaunchAgents/com.vandelay.agent.plist)
  • Windows: Creates a PID file at ~/.vandelay/vandelay.pid and launches a detached background process

uninstall

Remove the daemon service:

vandelay daemon uninstall

start / stop / restart

Control the daemon:

vandelay daemon start
vandelay daemon stop
vandelay daemon restart

status

Check if the daemon is running:

vandelay daemon status

logs

View daemon logs:

vandelay daemon logs
vandelay daemon logs --follow  # Tail logs

How It Works

The daemon runs vandelay start --server as a background service. It:

  • Starts the FastAPI server
  • Processes messages from all channels
  • Runs the scheduler engine for cron jobs and heartbeat
  • Restarts automatically if it crashes

Working Directory

The daemon runs from the user's home directory (~), not from ~/.vandelay. This ensures tools like shell and file operate relative to the home directory.

Manual Control

On Linux, you can also manage the daemon directly:

systemctl --user start vandelay
systemctl --user stop vandelay
systemctl --user restart vandelay
systemctl --user status vandelay
journalctl --user -u vandelay -f  # Tail logs