tota runs as a background daemon by default. Telegram and scheduled tasks keep working after you close the terminal.

#Start

tota start

Starts tota as a background daemon. Spawns a detached child process, writes a PID file to ~/.tota/daemon.pid, and redirects output to ~/.tota/daemon.log. Stale PID files are automatically cleaned up.

#Start in foreground

tota start --foreground

Runs tota attached to your terminal. Useful for debugging or when you want to see output directly. Shorthand: tota start -f.

#The easy way: tota up

tota up

This one command does everything: installs the system service if needed, starts the background daemon, and confirms tota is running. If it's already running, it just shows you the PID.

#Stop

tota stop

Sends SIGTERM (process.kill on Windows) to the background process and removes the PID file.

#Restart

tota restart

Stops the running daemon (if any) and starts a fresh one. Useful when something isn't working right and you need a clean restart.

#View logs

tota logs              # Show last 100 lines of daemon logs
tota logs -f           # Live-follow logs (Ctrl+C to stop)
tota logs -n 50        # Show last 50 lines
tota logs --clear      # Clear the log file

Logs are formatted with timestamps, color-coded levels (INFO/WARN/ERROR), and extra fields. The log file is at ~/.tota/daemon.log.

#Check status

tota status

Shows whether the daemon is running, its PID, and the log file path.