unerrdocs

pm

Manage the unerr process manager

Manage the unerr process manager

unerr pm [command]

pm start

Start the unerr process manager

unerr pm start [options]

Options

FlagDescriptionDefault
--foregroundRun in foreground (blocks terminal — useful for debugging)
--detachedRun in-process as a detached supervisor (used by auto-spawn)

pm stop

Stop a registered repo's process (by path or label); with no argument, stop the whole unerrd supervisor

unerr pm stop [path]

Arguments

ArgumentRequiredDescription
pathno

pm add

Register a repo with unerrd

unerr pm add [options] [path]

Arguments

ArgumentRequiredDescription
pathno

Options

FlagDescriptionDefault
--skip-parent-checkAllow registration even if parent dir is registered
--skip-child-checkAllow registration even if subdirectories are registered
--idle-timeout \<value\>Idle timeout in seconds before auto-stop (0 = never)
--java-build-tool \<value\>Java build tool override (Maven|Gradle|Bazel|Sbt)
--autostart \<value\>Warm-start policy on daemon boot (eager|auto|never)

pm remove

Unregister a repo from unerrd

unerr pm remove [path]

Arguments

ArgumentRequiredDescription
pathno

pm status

List all registered repos and their state

unerr pm status

pm config

View or modify per-repo settings

unerr pm config [options] [path]

Arguments

ArgumentRequiredDescription
pathno

Options

FlagDescriptionDefault
--showShow current settings without modifying
--idle-timeout \<value\>Idle timeout in seconds before auto-stop (0 = never)
--java-build-tool \<value\>Java build tool override (Maven|Gradle|Bazel|Sbt)
--autostart \<value\>Warm-start policy on daemon boot (eager|auto|never)

pm logs

Tail daemon and repo log files

unerr pm logs [options]

Options

FlagDescriptionDefault
--repo \<label\>Filter to a specific repo by label
--bridgeInclude bridge session logs
--followFollow log output (tail -f)
-n \<lines\>Number of lines to show50
--bootShow only entries from this boot cycle

pm dashboard

Open the unerr dashboard in browser

unerr pm dashboard [options]

Options

FlagDescriptionDefault
--port \<port\>Dashboard port (default: 9847)

pm set

Set global daemon configuration

unerr pm set [options]

Options

FlagDescriptionDefault
--warm-start-budget \<n\>Max repos to warm-start on boot (0=disabled)
--warm-start-idle-days \<n\>Skip repos inactive for N+ days
--warm-start-delay-ms \<n\>Delay after boot before warm-start

On this page