daemon

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

Options:

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

`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

# 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:


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

  # 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.                                         │
│ install     Install server daemons as background processes.                            │
│ uninstall   Uninstall server daemons.                                                  │
╰────────────────────────────────────────────────────────────────────────────────────────╯