Skip to main content
CLI Reference

travsr daemon

Manage the background daemon that processes reindex events from the git hook.

Synopsis

travsr daemon <subcommand> [flags]

Subcommands

SubcommandDescription
travsr daemon startStart the daemon
travsr daemon stopStop the running daemon
travsr daemon restartStop then start
travsr daemon statusPrint daemon status
travsr daemon logsTail daemon logs

travsr daemon start

travsr daemon start [--repos <path,...>] [--socket <path>] [--foreground]
FlagDefaultDescription
--repos <paths>cwdComma-separated list of repository roots to watch
--socket <path>/tmp/travsr.sockUnix socket path for MCP stdio
--foregroundfalseRun in the foreground instead of daemonizing
--log-file <path>/tmp/travsr.logLog output path

Example:

$ travsr daemon start

✓ Daemon started (PID 38142)
✓ Watching: /Users/me/my-project
✓ Listening on /tmp/travsr.sock

travsr daemon stop

travsr daemon stop

Sends SIGTERM to the daemon process and waits for it to exit cleanly.

travsr daemon status

$ travsr daemon status

Daemon status: running (PID 38142, uptime 2h 14m)
Socket: /tmp/travsr.sock
Watched repos: /Users/me/my-project (18 432 nodes, 94 751 edges)
Last reindex: 2026-05-26 14:33:11 (42 s ago, 23 files changed)

travsr daemon logs

travsr daemon logs [--lines <n>] [--follow]
FlagDefaultDescription
--lines <n>50Number of recent log lines to show
--followfalseTail logs continuously (like tail -f)

Auto-start on login

macOS (launchd):

travsr daemon install-service
# Creates ~/Library/LaunchAgents/com.travsr.daemon.plist

Linux (systemd user service):

travsr daemon install-service
# Creates ~/.config/systemd/user/travsr.service
systemctl --user enable travsr
systemctl --user start travsr