CLI Commands

Commands

pertmux serve

Start the background daemon.

pertmux serve                    # backgrounds automatically
pertmux -c config.toml serve     # with specific config
pertmux serve --foreground       # stay in terminal (for debugging)

The daemon forks to the background by default, logging to /tmp/pertmux-daemon.log. It validates your config and checks for an existing daemon before forking — errors show immediately in your terminal. Use --foreground to keep the daemon in your terminal for debugging.

The daemon runs until stopped with pertmux stop.

pertmux connect

Open the TUI client and connect to the running daemon.

pertmux connect

Fails with a clear error if the daemon is not running.

pertmux stop

Stop the running daemon.

pertmux stop

pertmux status

Show the daemon socket path and whether it’s running.

pertmux status

pertmux cleanup

Clean up stale files and persistence data.

pertmux cleanup

• Removes the stale socket file if the daemon is not running.
• Removes read_state.db (comment tracking) and last_project persistence files.
• Skips the live socket if the daemon is still running.

Global options

Option	Description
-c, --config <path>	Path to TOML config file
--version	Show version
-h, --help	Show help