agent-cli 0.77.0__tar.gz → 0.78.0__tar.gz

{agent_cli-0.77.0 → agent_cli-0.78.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.77.0
+Version: 0.78.0
 Summary: A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.
 Project-URL: Homepage, https://github.com/basnijholt/agent-cli
 Author-email: Bas Nijholt <bas@nijho.lt>

{agent_cli-0.77.0 → agent_cli-0.78.0}/agent_cli/daemon/cli.py

@@ -29,7 +29,8 @@ Install, uninstall, and monitor agent-cli servers running as system daemons
 | Daemon | Description | Ports |
 |--------|-------------|-------|
 | `whisper` | Speech-to-text ASR | 10300/10301 |
-| `tts` | Text-to-speech (Kokoro) | 10200/10201 |
+| `tts-kokoro` | Text-to-speech (GPU) | 10200/10201 |
+| `tts-piper` | Text-to-speech (CPU) | 10200/10201 |
 | `transcription-proxy` | ASR provider proxy | 61337 |
 
 **Examples:**
@@ -38,6 +39,9 @@ Install, uninstall, and monitor agent-cli servers running as system daemons
 # 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
 
@@ -62,10 +66,18 @@ def status_cmd(
             help="Service to check, or omit for all services",
         ),
     ] = None,
+    logs: Annotated[
+        int,
+        typer.Option(
+            "--logs",
+            "-l",
+            help="Number of recent log lines to show (0 to disable)",
+        ),
+    ] = 10,
 ) -> None:
     """Check status of installed daemons.
 
-    Shows whether each daemon is installed and running.
+    Shows whether each daemon is installed and running, along with recent log output.
 
     Examples:
         # Check all daemons
@@ -74,6 +86,12 @@ def status_cmd(
         # Check specific daemon
         agent-cli daemon status whisper
 
+        # Show more log lines
+        agent-cli daemon status tts-kokoro --logs 20
+
+        # Hide logs
+        agent-cli daemon status --logs 0
+
     """
     try:
         manager = get_service_manager()
@@ -102,12 +120,29 @@ def status_cmd(
         else:
             console.print(f"  {svc_name}: [yellow]installed but not running[/yellow]")
 
+        # Show recent logs for installed services
+        if logs > 0 and status.installed:
+            log_lines = manager.get_recent_logs(svc_name, logs)
+            if log_lines:
+                console.print()
+                console.print(f"  [dim]Recent logs ({len(log_lines)} lines):[/dim]")
+                max_line_width = 120
+                for line in log_lines:
+                    # Truncate long lines for readability
+                    display_line = (
+                        line[:max_line_width] + "..." if len(line) > max_line_width else line
+                    )
+                    console.print(f"    [dim]{display_line}[/dim]")
+            elif status.running:
+                console.print()
+                console.print("  [dim]No recent logs available[/dim]")
+
     console.print()
     system = platform.system()
     if system == "Darwin":
-        console.print("[dim]Log locations: ~/Library/Logs/agent-cli-<service>/[/dim]")
+        console.print("[dim]Full logs: ~/Library/Logs/agent-cli-<service>/[/dim]")
     else:
-        console.print("[dim]Log locations: journalctl --user -u agent-cli-<service>[/dim]")
+        console.print("[dim]Full logs: journalctl --user -u agent-cli-<service> -f[/dim]")
 
 
 def _confirm_action(message: str) -> bool:
@@ -158,7 +193,7 @@ def install_cmd(  # noqa: PLR0912, PLR0915
     services: Annotated[
         list[str] | None,
         typer.Argument(
-            help="Services to install (whisper, tts, transcription-proxy).",
+            help="Services to install (whisper, tts-kokoro, tts-piper, transcription-proxy).",
         ),
     ] = None,
     all_services: Annotated[
@@ -185,7 +220,8 @@ def install_cmd(  # noqa: PLR0912, PLR0915
 
     **Available daemons:**
     - **whisper**: Speech-to-text ASR server (ports 10300/10301)
-    - **tts**: Text-to-speech with Kokoro (ports 10200/10201)
+    - **tts-kokoro**: Text-to-speech with Kokoro/GPU (ports 10200/10201)
+    - **tts-piper**: Text-to-speech with Piper/CPU (ports 10200/10201)
     - **transcription-proxy**: Proxy for ASR providers (port 61337)
 
     Daemons run via `uv tool run` and don't require a virtual environment.
@@ -193,7 +229,7 @@ def install_cmd(  # noqa: PLR0912, PLR0915
     **Examples:**
 
         # Install specific daemons
-        agent-cli daemon install whisper tts
+        agent-cli daemon install whisper tts-kokoro
 
         # Install all daemons
         agent-cli daemon install --all
@@ -304,7 +340,7 @@ def uninstall_cmd(
     services: Annotated[
         list[str] | None,
         typer.Argument(
-            help="Services to uninstall (whisper, tts, transcription-proxy).",
+            help="Services to uninstall (whisper, tts-kokoro, tts-piper, transcription-proxy).",
         ),
     ] = None,
     all_services: Annotated[

{agent_cli-0.77.0 → agent_cli-0.78.0}/agent_cli/install/launchd.py

@@ -46,6 +46,30 @@ def _get_log_command(service_name: str) -> str:
     return f"tail -f {log_dir}/*.log"
 
 
+def _get_recent_logs(service_name: str, num_lines: int = 10) -> list[str]:
+    """Get recent log lines for a service."""
+    log_dir = _get_log_dir(service_name)
+    stderr_log = log_dir / "stderr.log"
+    stdout_log = log_dir / "stdout.log"
+
+    lines: list[str] = []
+
+    # Prefer stdout as it has structured output (startup message, usage examples)
+    # stderr often has noisy warnings from libraries like PyTorch/Kokoro
+    for log_file in [stdout_log, stderr_log]:
+        if log_file.exists():
+            try:
+                with log_file.open() as f:
+                    all_lines = f.readlines()
+                    lines = [line.rstrip() for line in all_lines[-num_lines:]]
+                    if lines:
+                        break
+            except OSError:
+                continue
+
+    return lines
+
+
 def _generate_plist(
     service: ServiceConfig,
     uv_path: Path,
@@ -217,4 +241,5 @@ manager = ServiceManager(
     uninstall_service=_uninstall_service,
     get_service_status=_get_service_status,
     get_log_command=_get_log_command,
+    get_recent_logs=_get_recent_logs,
 )

{agent_cli-0.77.0 → agent_cli-0.78.0}/agent_cli/install/service_config.py

@@ -42,14 +42,21 @@ SERVICES: dict[str, ServiceConfig] = {
         python_version="3.13",  # onnxruntime lacks py3.14 wheels (Linux only)
         macos_extra="server,mlx-whisper,wyoming",
     ),
-    "tts": ServiceConfig(
-        name="tts",
+    "tts-kokoro": ServiceConfig(
+        name="tts",  # Server command is still "tts"
         display_name="Kokoro TTS",
-        description="Text-to-speech server (ports 10200/10201)",
+        description="Text-to-speech with Kokoro (GPU, ports 10200/10201)",
         extra="server,kokoro,wyoming",
         command_args=["--backend", "kokoro"],
         python_version="3.12",  # curated-tokenizers (via kokoro→misaki→spacy) lacks py3.13 wheels
     ),
+    "tts-piper": ServiceConfig(
+        name="tts",  # Server command is still "tts"
+        display_name="Piper TTS",
+        description="Text-to-speech with Piper (CPU, ports 10200/10201)",
+        extra="server,piper,wyoming",
+        command_args=["--backend", "piper"],
+    ),
     "transcription-proxy": ServiceConfig(
         name="transcription-proxy",
         display_name="Transcription Proxy",
@@ -171,6 +178,7 @@ class ServiceManager(NamedTuple):
     uninstall_service: Callable[[str], UninstallResult]
     get_service_status: Callable[[str], ServiceStatus]
     get_log_command: Callable[[str], str]
+    get_recent_logs: Callable[[str, int], list[str]]
 
 
 def get_service_manager() -> ServiceManager:

{agent_cli-0.77.0 → agent_cli-0.78.0}/agent_cli/install/systemd.py

@@ -36,6 +36,31 @@ def _get_log_command(service_name: str) -> str:
     return f"journalctl --user -u agent-cli-{service_name} -f"
 
 
+def _get_recent_logs(service_name: str, num_lines: int = 10) -> list[str]:
+    """Get recent log lines for a service using journalctl."""
+    result = subprocess.run(
+        [  # noqa: S607
+            "journalctl",
+            "--user",
+            "-u",
+            f"agent-cli-{service_name}",
+            "-n",
+            str(num_lines),
+            "--no-pager",
+            "-o",
+            "cat",  # Output only the message, no metadata
+        ],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+
+    if result.returncode != 0:
+        return []
+
+    return [line.rstrip() for line in result.stdout.splitlines() if line.strip()]
+
+
 def _generate_unit_file(
     service: ServiceConfig,
     uv_path: Path,
@@ -252,4 +277,5 @@ manager = ServiceManager(
     uninstall_service=_uninstall_service,
     get_service_status=_get_service_status,
     get_log_command=_get_log_command,
+    get_recent_logs=_get_recent_logs,
 )

{agent_cli-0.77.0 → agent_cli-0.78.0}/agent_cli/server/cli.py

@@ -803,6 +803,18 @@ def tts_cmd(  # noqa: PLR0915
             'input="Hello")[/cyan]',
         )
     console.print()
+    voice = "af_heart" if resolved_backend == "kokoro" else "alloy"
+    console.print("[dim]Usage with agent-cli:[/dim]")
+    console.print(
+        f'  [cyan]ag speak "Hello" --tts-provider openai '
+        f"--tts-openai-base-url http://localhost:{port}/v1 --tts-openai-voice {voice}[/cyan]",
+    )
+    if not no_wyoming:
+        console.print(
+            f'  [cyan]ag speak "Hello" --tts-provider wyoming --tts-wyoming-ip {host} '
+            f"--tts-wyoming-port {wyoming_port}[/cyan]",
+        )
+    console.print()
 
     # Create and run the app
     from agent_cli.server.tts.api import create_app  # noqa: PLC0415

{agent_cli-0.77.0 → agent_cli-0.78.0}/agent_cli/services/tts.py

@@ -220,10 +220,13 @@ async def _synthesize_speech_kokoro(
     **_kwargs: object,
 ) -> bytes | None:
     """Synthesize speech from text using Kokoro TTS server via OpenAI client."""
+    host = kokoro_tts_cfg.tts_kokoro_host
+    if not host.startswith(("http://", "https://")):
+        host = f"http://{host}"
     openai_tts_cfg = config.OpenAITTS(
         tts_openai_model=kokoro_tts_cfg.tts_kokoro_model,
         tts_openai_voice=kokoro_tts_cfg.tts_kokoro_voice,
-        tts_openai_base_url=kokoro_tts_cfg.tts_kokoro_host,
+        tts_openai_base_url=host,
     )
     try:
         return await synthesize_speech_openai(

agent_cli-0.78.0/docs/commands/daemon.md

@@ -0,0 +1,174 @@
+---
+icon: lucide/settings
+---
+
+# daemon
+
+Manage agent-cli servers as background daemons.
+
+## Usage
+
+```bash
+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 |
+
+## Commands
+
+### `status`
+
+Check status of installed daemons.
+
+```bash
+# Check all daemons
+agent-cli daemon status
+
+# Check specific daemon
+agent-cli daemon status whisper
+```
+
+### `install`
+
+Install server daemons as background processes.
+
+```bash
+# 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.
+
+```bash
+# 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
+
+```bash
+# 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
+
+<details>
+<summary>See the output of <code>agent-cli daemon --help</code></summary>
+
+<!-- CODE:BASH:START -->
+<!-- echo '```yaml' -->
+<!-- export NO_COLOR=1 -->
+<!-- export TERM=dumb -->
+<!-- export COLUMNS=90 -->
+<!-- export TERMINAL_WIDTH=90 -->
+<!-- agent-cli daemon --help -->
+<!-- echo '```' -->
+<!-- CODE:END -->
+<!-- OUTPUT:START -->
+<!-- ⚠️ This content is auto-generated by `markdown-code-runner`. -->
+```yaml
+
+ 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
+
+
+ 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.                                                  │
+╰────────────────────────────────────────────────────────────────────────────────────────╯
+
+```
+
+<!-- OUTPUT:END -->
+
+</details>

{agent_cli-0.77.0 → agent_cli-0.78.0}/docs/commands/index.md

@@ -30,6 +30,7 @@ Agent CLI provides multiple commands, each designed for a specific purpose.
 | [`rag-proxy`](rag-proxy.md) | RAG server | Chat with your documents |
 | [`memory`](memory.md) | Long-term memory | Persistent conversation memory |
 | [`server`](server/index.md) | ASR & TTS servers | Local Whisper and Kokoro/Piper with TTL-based memory management |
+| [`daemon`](daemon.md) | Service manager | Install/manage servers as system daemons |
 
 The [`server`](server/index.md) command provides local ASR (speech-to-text) and TTS (text-to-speech) servers with unique advantages over standalone alternatives:
 

{agent_cli-0.77.0 → agent_cli-0.78.0}/tests/test_daemon.py

@@ -46,7 +46,8 @@ class TestServiceConfig:
     def test_services_defined(self) -> None:
         """Test that expected services are defined."""
         assert "whisper" in SERVICES
-        assert "tts" in SERVICES
+        assert "tts-kokoro" in SERVICES
+        assert "tts-piper" in SERVICES
         assert "transcription-proxy" in SERVICES
 
     def test_service_config_fields(self) -> None:

{agent_cli-0.77.0 → agent_cli-0.78.0}/zensical.toml

@@ -46,6 +46,7 @@ nav = [
         { "tts" = "commands/server/tts.md" },
         { "transcribe-proxy" = "commands/server/transcribe-proxy.md" },
       ] },
+      { "daemon" = "commands/daemon.md" },
     ] },
     { "Setup" = [
       { "config" = "commands/config.md" },