daemon

September 1, 2026 · View on GitHub

Manage agent-cli servers as background daemons.

Usage

agent-cli daemon [COMMAND] [OPTIONS]

Description

Install, uninstall, and monitor agent-cli servers running as system daemons:

macOS: launchd services (~/Library/LaunchAgents/)
Linux: systemd user services (~/.config/systemd/user/)

Daemons run via uv tool run and start automatically at login.

Available Daemons

Daemon	Description	Ports
`whisper`	Speech-to-text ASR server	10300/10301
`tts-kokoro`	Text-to-speech with Kokoro (GPU)	10200/10201
`tts-piper`	Text-to-speech with Piper (CPU)	10200/10201
`transcription-proxy`	ASR provider proxy	61337
`memory`	Long-term memory proxy for LLMs	8100
`rag`	Document retrieval proxy for LLMs	8000

Commands

`status`

Check status of installed daemons.

# Check all daemons
agent-cli daemon status

# Check specific daemon
agent-cli daemon status whisper

`install`

Install server daemons as background processes.

# Install specific daemons
agent-cli daemon install whisper tts-kokoro

# Install all daemons
agent-cli daemon install --all

# Skip confirmation prompts
agent-cli daemon install whisper -y

# Pass server args to one daemon command
agent-cli daemon install whisper -- --model small --port 10311

Options:

Option	Description
`--all, -a`	Install all available services
`--skip-deps`	Skip uv dependency check
`--no-confirm, -y`	Skip confirmation prompts

Arguments after -- are appended to the installed service command. This is only supported when installing exactly one daemon.

`uninstall`

Uninstall server daemons.

# Uninstall specific daemons
agent-cli daemon uninstall whisper tts-kokoro

# Uninstall all daemons
agent-cli daemon uninstall --all

Options:

Option	Description
`--all, -a`	Uninstall all installed services
`--no-confirm, -y`	Skip confirmation prompts

Examples

# Install whisper as a background daemon
agent-cli daemon install whisper

# Install Qwen3-ASR through the Transformers backend
agent-cli daemon install whisper -- \
  --backend transformers \
  --model Qwen/Qwen3-ASR-1.7B-hf

# Install whisper with custom server args
agent-cli daemon install whisper -- --model small --port 10311

# Check status of all daemons
agent-cli daemon status

# Uninstall a daemon
agent-cli daemon uninstall whisper

Logs

macOS: ~/Library/Logs/agent-cli-<service>/
Linux: journalctl --user -u agent-cli-<service> -f

Full Help

See the output of agent-cli daemon --help


 Usage: agent-cli daemon [OPTIONS] COMMAND [ARGS]...

 Manage agent-cli servers as background daemons.

 Install, uninstall, and monitor agent-cli servers running as system daemons (launchd on
 macOS, systemd on Linux).

 Available daemons:


  Daemon               Description               Ports
  ──────────────────────────────────────────────────────────
  whisper              Speech-to-text ASR        10300/10301
  tts-kokoro           Text-to-speech (GPU)      10200/10201
  tts-piper            Text-to-speech (CPU)      10200/10201
  transcription-proxy  ASR provider proxy        61337
  memory               Long-term memory proxy    8100
  rag                  Document retrieval proxy  8000


 Examples:


  # Ensure whisper is installed and running
  agent-cli daemon ensure whisper

  # Install whisper as a background daemon
  agent-cli daemon install whisper

  # Install whisper with custom server args
  agent-cli daemon install whisper -- --model small --port 10311

  # Install GPU-accelerated TTS
  agent-cli daemon install tts-kokoro

  # Check status of all daemons
  agent-cli daemon status

  # Uninstall a daemon
  agent-cli daemon uninstall whisper


 Daemons run via uv tool run and start automatically at login.

╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
│ --help  -h        Show this message and exit.                                          │
╰────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────────────────────────╮
│ status     Check status of installed daemons.                                          │
│ ensure     Ensure one daemon is installed and running.                                 │
│ install    Install server daemons as background processes.                             │
│ uninstall  Uninstall server daemons.                                                   │
╰────────────────────────────────────────────────────────────────────────────────────────╯