Skip to content
BENIBIX Learn

claude daemon Command

Also known as claude daemon, claude daemon status, Background session supervisor

It checks and stops the process that runs background jobs.

Think of it like

It is like a teacher who keeps an eye on all the kids at play.

Example

Emma's background sessions all stop at once. claude daemon status shows the supervisor is stuck. She stops it with --keep-workers, and the sessions come back.

Why it matters

When every background session fails together, the cause is the supervisor. This is how you reach it.

Definition

claude daemon looks after the supervisor, the process behind your background sessions. It is the one process that runs them all. claude daemon status prints its state and how many sessions it holds, and ends with code 1 if it is not running. claude daemon logs follows its log, ~/.claude/daemon.log. claude daemon stop shuts it down. Add --keep-workers to leave the sessions running for the next one.

Example code

bash
claude daemon status
Is the supervisor running?
claude daemon reaches the supervisor at the top.

Common mistake

Stopping it with no --keep-workers when you just want a restart. That ends each background session it ran.

Key takeaways

  1. 1
    One supervisor. Runs every session.
  2. 2
    status and logs. See what it does.
  3. 3
    stop. --keep-workers to keep them.

Learn it properly