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

Shows the last 100 lines of ~/.tota/daemon.log.

Check status

tota status

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