Skip to main content

Daemon

Goal​

Understand when to use the Keypress daemon and how to recover if it gets stuck.

What It Is​

The daemon is a background helper that keeps session management available even when you are not actively typing in the terminal. In normal use, Keypress starts it automatically when needed.

Common Commands​

keypress daemon start
keypress daemon stop
keypress daemon status
keypress daemon list
keypress daemon stop-session <session-id>
keypress daemon logs
keypress daemon install
keypress daemon uninstall

Recovery Flow (If Something Feels Stuck)​

  1. Check status:
keypress daemon status
  1. Restart daemon:
keypress daemon stop
keypress daemon start
  1. If needed, inspect logs:
keypress daemon logs
  1. Run diagnostics:
keypress doctor
Screenshot Placeholder
  • What to capture: keypress daemon status output followed by a successful restart.
  • Why this screenshot matters: Gives users a concrete recovery pattern to follow.
  • Suggested filename: cli-daemon-recovery-flow.png

Expected Result​

Daemon commands are clear, and users can self-recover common background-session issues.

Next Step​

Go to Common Issues for symptom-based fixes.