agent-cli 0.68.4__py3-none-any.whl → 0.69.0__py3-none-any.whl

agent_cli/_requirements/audio.txt

@@ -11,7 +11,9 @@ certifi==2026.1.4
 cffi==2.0.0
     # via sounddevice
 click==8.3.1
-    # via typer-slim
+    # via
+    #   typer
+    #   typer-slim
 colorama==0.4.6 ; sys_platform == 'win32'
     # via click
 dotenv==0.9.9
@@ -49,13 +51,18 @@ python-dotenv==1.2.1
 rich==14.2.0
     # via
     #   agent-cli
+    #   typer
     #   typer-slim
 setproctitle==1.3.7
     # via agent-cli
 shellingham==1.5.4
-    # via typer-slim
+    # via
+    #   typer
+    #   typer-slim
 sounddevice==0.5.3
     # via agent-cli
+typer==0.21.1
+    # via agent-cli
 typer-slim==0.21.1
     # via agent-cli
 typing-extensions==4.15.0
@@ -63,6 +70,7 @@ typing-extensions==4.15.0
     #   anyio
     #   pydantic
     #   pydantic-core
+    #   typer
     #   typer-slim
     #   typing-inspection
 typing-inspection==0.4.2

agent_cli/_requirements/faster-whisper.txt

@@ -176,6 +176,7 @@ tqdm==4.67.1
     #   huggingface-hub
 typer==0.21.1
     # via
+    #   agent-cli
     #   fastapi-cli
     #   fastapi-cloud-cli
 typer-slim==0.21.1

agent_cli/_requirements/kokoro.txt

@@ -367,6 +367,7 @@ triton==3.5.1 ; platform_machine == 'x86_64' and sys_platform == 'linux'
     # via torch
 typer==0.21.1
     # via
+    #   agent-cli
     #   fastapi-cli
     #   fastapi-cloud-cli
 typer-slim==0.21.1

agent_cli/_requirements/llm.txt

@@ -23,6 +23,7 @@ charset-normalizer==3.4.4
 click==8.3.1
     # via
     #   ddgs
+    #   typer
     #   typer-slim
 colorama==0.4.6
     # via
@@ -132,13 +133,16 @@ requests==2.32.5
 rich==14.2.0
     # via
     #   agent-cli
+    #   typer
     #   typer-slim
 rsa==4.9.1
     # via google-auth
 setproctitle==1.3.7
     # via agent-cli
 shellingham==1.5.4
-    # via typer-slim
+    # via
+    #   typer
+    #   typer-slim
 sniffio==1.3.1
     # via
     #   google-genai
@@ -151,6 +155,8 @@ tiktoken==0.12.0
     # via pydantic-ai-slim
 tqdm==4.67.1
     # via openai
+typer==0.21.1
+    # via agent-cli
 typer-slim==0.21.1
     # via agent-cli
 typing-extensions==4.15.0
@@ -161,6 +167,7 @@ typing-extensions==4.15.0
     #   opentelemetry-api
     #   pydantic
     #   pydantic-core
+    #   typer
     #   typer-slim
     #   typing-inspection
 typing-inspection==0.4.2

agent_cli/_requirements/memory.txt

@@ -300,6 +300,7 @@ transformers==4.57.5
     # via agent-cli
 typer==0.21.1
     # via
+    #   agent-cli
     #   chromadb
     #   fastapi-cli
     #   fastapi-cloud-cli

agent_cli/_requirements/mlx-whisper.txt

@@ -180,8 +180,9 @@ tqdm==4.67.1 ; platform_machine == 'arm64' and sys_platform == 'darwin'
     # via
     #   huggingface-hub
     #   mlx-whisper
-typer==0.21.1 ; platform_machine == 'arm64' and sys_platform == 'darwin'
+typer==0.21.1
     # via
+    #   agent-cli
     #   fastapi-cli
     #   fastapi-cloud-cli
 typer-slim==0.21.1

agent_cli/_requirements/piper.txt

@@ -140,6 +140,7 @@ sympy==1.14.0
     # via onnxruntime
 typer==0.21.1
     # via
+    #   agent-cli
     #   fastapi-cli
     #   fastapi-cloud-cli
 typer-slim==0.21.1

agent_cli/_requirements/rag.txt

@@ -343,6 +343,7 @@ transformers==4.57.5
     # via agent-cli
 typer==0.21.1
     # via
+    #   agent-cli
     #   chromadb
     #   fastapi-cli
     #   fastapi-cloud-cli

agent_cli/_requirements/server.txt

@@ -118,6 +118,7 @@ starlette==0.50.0
     # via fastapi
 typer==0.21.1
     # via
+    #   agent-cli
     #   fastapi-cli
     #   fastapi-cloud-cli
 typer-slim==0.21.1

agent_cli/_requirements/speed.txt

@@ -11,7 +11,9 @@ certifi==2026.1.4
     #   httpcore
     #   httpx
 click==8.3.1
-    # via typer-slim
+    # via
+    #   typer
+    #   typer-slim
 colorama==0.4.6 ; sys_platform == 'win32'
     # via click
 dotenv==0.9.9
@@ -49,13 +51,18 @@ python-dotenv==1.2.1
 rich==14.2.0
     # via
     #   agent-cli
+    #   typer
     #   typer-slim
 setproctitle==1.3.7
     # via agent-cli
 shellingham==1.5.4
-    # via typer-slim
+    # via
+    #   typer
+    #   typer-slim
 termcolor==3.3.0
     # via fire
+typer==0.21.1
+    # via agent-cli
 typer-slim==0.21.1
     # via agent-cli
 typing-extensions==4.15.0
@@ -63,6 +70,7 @@ typing-extensions==4.15.0
     #   anyio
     #   pydantic
     #   pydantic-core
+    #   typer
     #   typer-slim
     #   typing-inspection
 typing-inspection==0.4.2

agent_cli/_requirements/vad.txt

@@ -9,7 +9,9 @@ certifi==2026.1.4
     #   httpcore
     #   httpx
 click==8.3.1
-    # via typer-slim
+    # via
+    #   typer
+    #   typer-slim
 colorama==0.4.6 ; sys_platform == 'win32'
     # via click
 coloredlogs==15.0.1
@@ -112,13 +114,16 @@ python-dotenv==1.2.1
 rich==14.2.0
     # via
     #   agent-cli
+    #   typer
     #   typer-slim
 setproctitle==1.3.7
     # via agent-cli
 setuptools==80.9.0 ; python_full_version >= '3.12'
     # via torch
 shellingham==1.5.4
-    # via typer-slim
+    # via
+    #   typer
+    #   typer-slim
 silero-vad==6.2.0
     # via agent-cli
 sympy==1.14.0
@@ -133,6 +138,8 @@ torchaudio==2.9.1
     # via silero-vad
 triton==3.5.1 ; platform_machine == 'x86_64' and sys_platform == 'linux'
     # via torch
+typer==0.21.1
+    # via agent-cli
 typer-slim==0.21.1
     # via agent-cli
 typing-extensions==4.15.0
@@ -141,6 +148,7 @@ typing-extensions==4.15.0
     #   pydantic
     #   pydantic-core
     #   torch
+    #   typer
     #   typer-slim
     #   typing-inspection
 typing-inspection==0.4.2

agent_cli/agents/autocorrect.py

@@ -9,7 +9,6 @@ import sys
 import time
 from typing import TYPE_CHECKING
 
-import pyperclip
 import typer
 
 from agent_cli import config, opts
@@ -118,6 +117,8 @@ def _display_result(
 ) -> None:
     """Handle output and clipboard copying based on desired verbosity."""
     if clipboard:
+        import pyperclip  # noqa: PLC0415
+
         pyperclip.copy(corrected_text)
 
     if simple_output:

agent_cli/agents/memory/__init__.py

@@ -10,6 +10,7 @@ from agent_cli.core.process import set_process_title
 memory_app = typer.Typer(
     name="memory",
     help="Memory system operations (add, proxy, etc.).",
+    add_completion=True,
     rich_markup_mode="markdown",
     no_args_is_help=True,
 )

agent_cli/agents/memory/proxy.py

@@ -11,7 +11,7 @@ from rich.logging import RichHandler
 from agent_cli import constants, opts
 from agent_cli.agents.memory import memory_app
 from agent_cli.core.deps import requires_extras
-from agent_cli.core.utils import console, print_command_line_args, print_error_message
+from agent_cli.core.utils import console, print_command_line_args
 
 
 @memory_app.command("proxy")
@@ -105,17 +105,10 @@ def proxy(
     if print_args:
         print_command_line_args(locals())
 
-    try:
-        import uvicorn  # noqa: PLC0415
-
-        from agent_cli.memory._files import ensure_store_dirs  # noqa: PLC0415
-        from agent_cli.memory.api import create_app  # noqa: PLC0415
-    except ImportError as exc:
-        print_error_message(
-            "Memory dependencies are not installed. Please install with "
-            "`pip install agent-cli[memory]` or `uv sync --extra memory`.",
-        )
-        raise typer.Exit(1) from exc
+    import uvicorn  # noqa: PLC0415
+
+    from agent_cli.memory._files import ensure_store_dirs  # noqa: PLC0415
+    from agent_cli.memory.api import create_app  # noqa: PLC0415
 
     logging.basicConfig(
         level=log_level.upper(),

agent_cli/agents/rag_proxy.py

@@ -77,16 +77,9 @@ def rag_proxy(
     logging.getLogger("chromadb").setLevel(logging.WARNING)
     logging.getLogger("uvicorn.access").setLevel(logging.WARNING)
 
-    try:
-        import uvicorn  # noqa: PLC0415
+    import uvicorn  # noqa: PLC0415
 
-        from agent_cli.rag.api import create_app  # noqa: PLC0415
-    except ImportError as exc:
-        print_error_message(
-            "RAG dependencies are not installed. Please install with "
-            "`pip install agent-cli[rag]` or `uv sync --extra rag`.",
-        )
-        raise typer.Exit(1) from exc
+    from agent_cli.rag.api import create_app  # noqa: PLC0415
 
     docs_folder = docs_folder.resolve()
     chroma_path = chroma_path.resolve()

agent_cli/agents/transcribe.py

@@ -12,7 +12,6 @@ from datetime import UTC, datetime, timedelta
 from pathlib import Path  # noqa: TC003
 from typing import Any, TypedDict
 
-import pyperclip
 import typer
 
 from agent_cli import config, opts
@@ -364,6 +363,8 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
                 )
             clipboard_snapshot: str | None = None
             if general_cfg.clipboard:
+                import pyperclip  # noqa: PLC0415
+
                 clipboard_snapshot = pyperclip.paste()
                 pyperclip.copy(transcript)
                 LOGGER.info("Copied raw transcript to clipboard before LLM processing.")
@@ -445,6 +446,8 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
             )
 
         if general_cfg.clipboard:
+            import pyperclip  # noqa: PLC0415
+
             pyperclip.copy(transcript)
             LOGGER.info("Copied transcript to clipboard.")
         else:

agent_cli/cli.py

@@ -2,9 +2,12 @@
 
 from __future__ import annotations
 
+import sys
+from pathlib import Path
 from typing import Annotated
 
 import typer
+from rich.table import Table
 
 from . import __version__
 from .config import load_config, normalize_provider_defaults
@@ -14,15 +17,28 @@ from .core.utils import console
 app = typer.Typer(
     name="agent-cli",
     help="A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.",
-    add_completion=True,
     context_settings={"help_option_names": ["-h", "--help"]},
+    add_completion=True,
     rich_markup_mode="markdown",
+    no_args_is_help=True,
 )
 
 
 def _version_callback(value: bool) -> None:
     if value:
-        console.print(f"agent-cli {__version__}")
+        path = Path(__file__).parent
+        data = [
+            ("agent-cli version", __version__),
+            ("agent-cli location", str(path)),
+            ("Python version", sys.version),
+            ("Python executable", sys.executable),
+        ]
+        table = Table(show_header=False)
+        table.add_column("Property", style="cyan")
+        table.add_column("Value", style="magenta")
+        for prop, val in data:
+            table.add_row(prop, val)
+        console.print(table)
         raise typer.Exit
 
 

agent_cli/config_cmd.py

@@ -21,6 +21,7 @@ from agent_cli.core.utils import console
 config_app = typer.Typer(
     name="config",
     help="Manage agent-cli configuration files.",
+    add_completion=True,
     rich_markup_mode="markdown",
     no_args_is_help=True,
 )

agent_cli/core/chroma.py

@@ -4,10 +4,6 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
 
-import chromadb
-from chromadb.config import Settings
-from chromadb.utils import embedding_functions
-
 from agent_cli.constants import DEFAULT_OPENAI_EMBEDDING_MODEL
 
 if TYPE_CHECKING:
@@ -28,6 +24,10 @@ def init_collection(
     subdir: str | None = None,
 ) -> Collection:
     """Initialize a Chroma collection with OpenAI-compatible embeddings."""
+    import chromadb  # noqa: PLC0415
+    from chromadb.config import Settings  # noqa: PLC0415
+    from chromadb.utils import embedding_functions  # noqa: PLC0415
+
     target_path = persistence_path / subdir if subdir else persistence_path
     target_path.mkdir(parents=True, exist_ok=True)
     client = chromadb.PersistentClient(

agent_cli/core/deps.py

@@ -142,7 +142,7 @@ def _try_auto_install(missing: list[str]) -> bool:
     console.print(
         f"[yellow]Auto-installing missing extras: {', '.join(extras_to_install)}[/]",
     )
-    return install_extras_programmatic(extras_to_install)
+    return install_extras_programmatic(extras_to_install, quiet=True)
 
 
 def _check_and_install_extras(extras: tuple[str, ...]) -> list[str]:

agent_cli/core/openai_proxy.py

@@ -6,13 +6,11 @@ import json
 import logging
 from typing import TYPE_CHECKING, Any, Protocol, runtime_checkable
 
-import httpx
-from fastapi import HTTPException, Request, Response
-from fastapi.responses import StreamingResponse
-
 if TYPE_CHECKING:
     from collections.abc import AsyncGenerator, Iterable
 
+    from fastapi import Request, Response
+
 LOGGER = logging.getLogger(__name__)
 
 
@@ -33,6 +31,9 @@ async def proxy_request_to_upstream(
     api_key: str | None = None,
 ) -> Response:
     """Forward a raw HTTP request to an upstream OpenAI-compatible provider."""
+    import httpx  # noqa: PLC0415
+    from fastapi import Response  # noqa: PLC0415
+
     auth_header = request.headers.get("Authorization")
     headers = {}
     if auth_header:
@@ -82,6 +83,10 @@ async def forward_chat_request(
     exclude_fields: Iterable[str] = (),
 ) -> Any:
     """Forward a chat request to a backend LLM."""
+    import httpx  # noqa: PLC0415
+    from fastapi import HTTPException  # noqa: PLC0415
+    from fastapi.responses import StreamingResponse  # noqa: PLC0415
+
     forward_payload = request.model_dump(exclude=set(exclude_fields))
     headers = {"Authorization": f"Bearer {api_key}"} if api_key else None
 

agent_cli/core/process.py

@@ -10,8 +10,6 @@ from contextlib import contextmanager
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-import setproctitle
-
 if TYPE_CHECKING:
     from collections.abc import Generator
 
@@ -36,6 +34,8 @@ def set_process_title(process_name: str) -> None:
         process_name: The name of the process (e.g., 'transcribe', 'chat').
 
     """
+    import setproctitle  # noqa: PLC0415
+
     global _original_proctitle
 
     # Capture the original command line only once, before any modification

agent_cli/core/reranker.py

@@ -4,15 +4,13 @@ from __future__ import annotations
 
 import logging
 
-from huggingface_hub import hf_hub_download
-from onnxruntime import InferenceSession
-from transformers import AutoTokenizer
-
 LOGGER = logging.getLogger(__name__)
 
 
 def _download_onnx_model(model_name: str, onnx_filename: str) -> str:
     """Download the ONNX model, favoring the common `onnx/` folder layout."""
+    from huggingface_hub import hf_hub_download  # noqa: PLC0415
+
     if "/" in onnx_filename:
         return hf_hub_download(repo_id=model_name, filename=onnx_filename)
 
@@ -45,6 +43,9 @@ class OnnxCrossEncoder:
         onnx_filename: str = "model.onnx",
     ) -> None:
         """Initialize the ONNX CrossEncoder."""
+        from onnxruntime import InferenceSession  # noqa: PLC0415
+        from transformers import AutoTokenizer  # noqa: PLC0415
+
         self.model_name = model_name
 
         # Download model if needed

agent_cli/core/utils.py

@@ -18,7 +18,6 @@ from contextlib import (
 )
 from typing import TYPE_CHECKING, Any
 
-import pyperclip
 from rich.console import Console
 from rich.live import Live
 from rich.panel import Panel
@@ -40,6 +39,7 @@ if TYPE_CHECKING:
     from pathlib import Path
 
 console = Console()
+err_console = Console(stderr=True)
 
 
 def enable_json_mode() -> None:
@@ -233,6 +233,8 @@ def print_device_index(input_device_index: int | None, input_device_name: str |
 
 def get_clipboard_text(*, quiet: bool = False) -> str | None:
     """Get text from clipboard, with an optional status message."""
+    import pyperclip  # noqa: PLC0415
+
     text = pyperclip.paste()
     if not text:
         if not quiet:

agent_cli/core/vad.py

@@ -12,7 +12,6 @@ from agent_cli import constants
 try:
     import numpy as np
     import torch
-    from silero_vad.utils_vad import OnnxWrapper
 except ImportError as e:
     msg = (
         "silero-vad is required for the transcribe-daemon command. "
@@ -57,6 +56,8 @@ class VoiceActivityDetector:
             msg = f"Sample rate must be 8000 or 16000, got {sample_rate}"
             raise ValueError(msg)
 
+        from silero_vad.utils_vad import OnnxWrapper  # noqa: PLC0415
+
         self.sample_rate = sample_rate
         self.threshold = threshold
         self.silence_threshold_ms = silence_threshold_ms

agent_cli/core/watch.py

@@ -3,13 +3,13 @@
 from __future__ import annotations
 
 import asyncio
-from collections.abc import Callable
 from pathlib import Path
+from typing import TYPE_CHECKING
 
-from watchfiles import Change, awatch
+if TYPE_CHECKING:
+    from collections.abc import Callable
 
-ChangeHandler = Callable[[Change, Path], None]
-PathFilter = Callable[[Path, Path], bool]
+    from watchfiles import Change
 
 
 def _default_skip_hidden(path: Path, root: Path) -> bool:
@@ -20,10 +20,10 @@ def _default_skip_hidden(path: Path, root: Path) -> bool:
 
 async def watch_directory(
     root: Path,
-    handler: ChangeHandler,
+    handler: Callable[[Change, Path], None],
     *,
     skip_hidden: bool = True,
-    ignore_filter: PathFilter | None = None,
+    ignore_filter: Callable[[Path, Path], bool] | None = None,
     use_executor: bool = True,
 ) -> None:
     """Watch a directory for file changes and invoke handler(change, path).
@@ -38,6 +38,8 @@ async def watch_directory(
         use_executor: If True, run handler in a thread pool executor.
 
     """
+    from watchfiles import awatch  # noqa: PLC0415
+
     loop = asyncio.get_running_loop()
 
     # Determine which filter to use

agent_cli/dev/cli.py

@@ -13,7 +13,6 @@ from pathlib import Path
 from typing import TYPE_CHECKING, Annotated, NoReturn
 
 import typer
-from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
 
@@ -21,6 +20,7 @@ from agent_cli.cli import app as main_app
 from agent_cli.cli import set_config_defaults
 from agent_cli.config import load_config
 from agent_cli.core.process import set_process_title
+from agent_cli.core.utils import console, err_console
 
 # Word lists for generating random branch names (like Docker container names)
 _ADJECTIVES = [
@@ -112,9 +112,6 @@ if TYPE_CHECKING:
     from .coding_agents.base import CodingAgent
     from .editors.base import Editor
 
-console = Console()
-err_console = Console(stderr=True)
-
 app = typer.Typer(
     name="dev",
     help="Parallel development environment manager using git worktrees.",
@@ -478,7 +475,7 @@ def _launch_agent(
 
 
 @app.command("new")
-def new(  # noqa: PLR0912, PLR0915
+def new(  # noqa: C901, PLR0912, PLR0915
     branch: Annotated[
         str | None,
         typer.Argument(help="Branch name (auto-generated if not provided)"),
@@ -565,6 +562,10 @@ def new(  # noqa: PLR0912, PLR0915
     if prompt_file is not None:
         prompt = prompt_file.read_text().strip()
 
+    # If a prompt is provided, automatically enable agent mode
+    if prompt:
+        agent = True
+
     repo_root = _ensure_git_repo()
 
     # Generate branch name if not provided

agent_cli/dev/coding_agents/base.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import os
 import shutil
 from abc import ABC
+from pathlib import PurePath
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -131,8 +132,6 @@ def _get_parent_process_names() -> list[str]:
     - CLI tools that set process.title (like Claude) show their name directly
     """
     try:
-        from pathlib import PurePath  # noqa: PLC0415
-
         import psutil  # noqa: PLC0415
 
         process = psutil.Process(os.getpid())