Skip to content
workmux branch logoworkmux branch logoworkmux

reap-agents

Copy page

Exit tracked agent processes whose last state update is older than a threshold.

Terminal window
workmux reap-agents
workmux reap-agents --hours 48
workmux reap-agents --hours 24 --force

By default, the command prints matching agents without exiting them. It still reconciles workmux state while checking live panes. Pass --force to interrupt matching agents and remove their workmux agent state after they exit.

Options

Section titled “Options”
  • --hours <hours>: Age threshold in hours. Defaults to 24.
  • -f, --force: Actually exit matching agents instead of showing what would happen.

Example output

Section titled “Example output”
Would exit %12 in feature-a (25h, done, Update docs)
Run with -f/--force to exit these agents.