agent-cli 0.61.5__py3-none-any.whl → 0.62.0__py3-none-any.whl

agent_cli/agents/assistant.py

@@ -253,7 +253,7 @@ async def _async_main(
                 print_with_style("✨ Ready for next command...", style="green")
 
 
-@app.command("assistant")
+@app.command("assistant", rich_help_panel="Voice Commands")
 def assistant(
     *,
     # --- Provider Selection ---

agent_cli/agents/autocorrect.py

@@ -208,7 +208,7 @@ async def _async_autocorrect(
         sys.exit(1)
 
 
-@app.command("autocorrect")
+@app.command("autocorrect", rich_help_panel="Text Commands")
 def autocorrect(
     *,
     text: str | None = typer.Argument(

agent_cli/agents/chat.py

@@ -373,7 +373,7 @@ async def _async_main(
         raise
 
 
-@app.command("chat")
+@app.command("chat", rich_help_panel="Voice Commands")
 def chat(
     *,
     # --- Provider Selection ---

agent_cli/agents/memory/__init__.py

@@ -14,7 +14,7 @@ memory_app = typer.Typer(
     no_args_is_help=True,
 )
 
-app.add_typer(memory_app, name="memory")
+app.add_typer(memory_app, name="memory", rich_help_panel="Servers")
 
 
 @memory_app.callback()

agent_cli/agents/rag_proxy.py

@@ -17,7 +17,7 @@ from agent_cli.core.utils import (
 )
 
 
-@app.command("rag-proxy")
+@app.command("rag-proxy", rich_help_panel="Servers")
 def rag_proxy(
     docs_folder: Path = typer.Option(  # noqa: B008
         "./rag_docs",

agent_cli/agents/speak.py

@@ -79,7 +79,7 @@ async def _async_main(
     return text
 
 
-@app.command("speak")
+@app.command("speak", rich_help_panel="Text Commands")
 def speak(
     *,
     text: str | None = typer.Argument(

agent_cli/agents/transcribe.py

@@ -460,7 +460,7 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
     )
 
 
-@app.command("transcribe")
+@app.command("transcribe", rich_help_panel="Voice Commands")
 def transcribe(  # noqa: PLR0912
     *,
     extra_instructions: str | None = typer.Option(

agent_cli/agents/transcribe_daemon.py

@@ -286,7 +286,7 @@ async def _daemon_loop(cfg: DaemonConfig) -> None:  # noqa: PLR0912, PLR0915
                     await asyncio.wait(background_tasks, timeout=2.0)
 
 
-@app.command("transcribe-daemon")
+@app.command("transcribe-daemon", rich_help_panel="Voice Commands")
 def transcribe_daemon(  # noqa: PLR0912
     *,
     # Daemon-specific options

agent_cli/agents/voice_edit.py

@@ -172,7 +172,7 @@ async def _async_main(
         )
 
 
-@app.command("voice-edit")
+@app.command("voice-edit", rich_help_panel="Voice Commands")
 def voice_edit(
     *,
     # --- Provider Selection ---

agent_cli/dev/cli.py

@@ -122,7 +122,7 @@ app = typer.Typer(
     rich_markup_mode="markdown",
     no_args_is_help=True,
 )
-main_app.add_typer(app, name="dev")
+main_app.add_typer(app, name="dev", rich_help_panel="Development")
 
 
 @app.callback()

agent_cli/dev/worktree.py

@@ -55,6 +55,15 @@ def is_git_repo(path: Path | None = None) -> bool:
         return False
 
 
+def has_origin_remote(path: Path | None = None) -> bool:
+    """Check if the repository has an 'origin' remote configured."""
+    try:
+        result = _run_git("remote", "get-url", "origin", cwd=path, check=False)
+        return result.returncode == 0
+    except Exception:
+        return False
+
+
 def get_repo_root(path: Path | None = None) -> Path | None:
     """Get the root directory of the git repository."""
     try:
@@ -461,6 +470,35 @@ def _init_submodules(
     )
 
 
+def _pull_lfs(
+    worktree_path: Path,
+    *,
+    on_log: Callable[[str], None] | None = None,
+    capture_output: bool = True,
+) -> None:
+    """Pull Git LFS files in a worktree if LFS is used.
+
+    Evidence: https://git-lfs.com/ - `git lfs pull` fetches LFS objects.
+    This is a no-op if LFS is not used or files are already present.
+    """
+    # Check if .gitattributes contains LFS filters
+    gitattributes = worktree_path / ".gitattributes"
+    if not gitattributes.exists():
+        return
+
+    if "filter=lfs" not in gitattributes.read_text():
+        return
+
+    # Check if git-lfs is installed
+    if not shutil.which("git-lfs"):
+        return
+
+    if on_log:
+        on_log("Pulling Git LFS files...")
+
+    _run_git("lfs", "pull", cwd=worktree_path, check=False, capture_output=capture_output)
+
+
 def _add_worktree(
     branch_name: str,
     worktree_path: Path,
@@ -586,8 +624,11 @@ def create_worktree(
     # Create base directory if needed
     base_dir.mkdir(parents=True, exist_ok=True)
 
-    # Fetch latest refs
-    if fetch:
+    # Check if origin remote exists
+    origin_exists = has_origin_remote(repo_root)
+
+    # Fetch latest refs (only if origin exists)
+    if fetch and origin_exists:
         if on_log:
             on_log("Running: git fetch origin")
         _run_git("fetch", "origin", cwd=repo_root, check=False, capture_output=capture_output)
@@ -596,10 +637,10 @@ def create_worktree(
     from_ref_explicit = from_ref is not None
 
     # Determine the reference to create from
-    # Use origin/{branch} to ensure we're using the freshly-fetched remote ref,
-    # not a potentially stale local branch
+    # Use origin/{branch} if origin exists, otherwise use local branch
     if from_ref is None:
-        from_ref = f"origin/{get_default_branch(repo_root)}"
+        default_branch = get_default_branch(repo_root)
+        from_ref = f"origin/{default_branch}" if origin_exists else default_branch
 
     # Check if branch exists remotely or locally
     remote_exists, local_exists = _check_branch_exists(branch_name, repo_root)
@@ -634,6 +675,13 @@ def create_worktree(
             capture_output=capture_output,
         )
 
+        # Pull Git LFS files if the repo uses LFS
+        _pull_lfs(
+            worktree_path,
+            on_log=on_log,
+            capture_output=capture_output,
+        )
+
         return CreateWorktreeResult(
             success=True,
             path=worktree_path,

agent_cli/server/cli.py

@@ -34,7 +34,7 @@ app = typer.Typer(
     rich_markup_mode="markdown",
     no_args_is_help=True,
 )
-main_app.add_typer(app, name="server")
+main_app.add_typer(app, name="server", rich_help_panel="Servers")
 
 
 @app.callback()

{agent_cli-0.61.5.dist-info → agent_cli-0.62.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.61.5
+Version: 0.62.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>
@@ -128,7 +128,7 @@ Since then I have expanded the tool with many more features, all focused on loca
 - **[`memory`](docs/commands/memory.md)**: Long-term memory system with `memory proxy` and `memory add`.
 - **[`rag-proxy`](docs/commands/rag-proxy.md)**: RAG proxy server for chatting with your documents.
 - **[`dev`](docs/commands/dev.md)**: Parallel development with git worktrees and AI coding agents.
-- **[`server`](docs/commands/server.md)**: Local ASR and TTS servers with dual-protocol (Wyoming & OpenAI), TTL-based memory management, and multi-platform acceleration. Whisper uses MLX on Apple Silicon or Faster Whisper on Linux/CUDA. TTS supports Kokoro (GPU) or Piper (CPU).
+- **[`server`](docs/commands/server/index.md)**: Local ASR and TTS servers with dual-protocol (Wyoming & OpenAI), TTL-based memory management, and multi-platform acceleration. Whisper uses MLX on Apple Silicon or Faster Whisper on Linux/CUDA. TTS supports Kokoro (GPU) or Piper (CPU).
 - **[`transcribe-daemon`](docs/commands/transcribe-daemon.md)**: Continuous background transcription with VAD. Install with `uv tool install "agent-cli[vad]"`.
 
 ## Quick Start
@@ -389,7 +389,7 @@ Our installation scripts automatically handle all dependencies:
 |---------|---------|-----------------|
 | **[Ollama](https://ollama.ai/)** | Local LLM for text processing | ✅ Yes, with default model |
 | **[Wyoming Faster Whisper](https://github.com/rhasspy/wyoming-faster-whisper)** | Speech-to-text | ✅ Yes, via `uvx` |
-| **[`agent-cli server whisper`](docs/commands/server.md#whisper)** | Speech-to-text (alternative) | ✅ Built-in, `pip install "agent-cli[whisper]"` |
+| **[`agent-cli server whisper`](docs/commands/server/whisper.md)** | Speech-to-text (alternative) | ✅ Built-in, `pip install "agent-cli[whisper]"` |
 | **[Wyoming Piper](https://github.com/rhasspy/wyoming-piper)** | Text-to-speech | ✅ Yes, via `uvx` |
 | **[Kokoro-FastAPI](https://github.com/remsky/Kokoro-FastAPI)** | Premium TTS (optional) | ⚙️ Can be added later |
 | **[Wyoming openWakeWord](https://github.com/rhasspy/wyoming-openwakeword)** | Wake word detection | ✅ Yes, for `assistant` |

{agent_cli-0.61.5.dist-info → agent_cli-0.62.0.dist-info}/RECORD

@@ -12,15 +12,15 @@ agent_cli/opts.py,sha256=qMK_mLxzGAbX7C2IYuCFvOkLgaxCCMO66I9ps8AdrYo,12114
 agent_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agent_cli/agents/__init__.py,sha256=c1rnncDW5pBvP6BiLzFVpLWDNZzFRaUA7-a97avFVAs,321
 agent_cli/agents/_voice_agent_common.py,sha256=PUAztW84Xf9U7d0C_K5cL7I8OANIE1H6M8dFD_cRqps,4360
-agent_cli/agents/assistant.py,sha256=kDlKr2lksG2CuIs0QxtMlgJ9a5G29fCOf-rW3t88l8M,13931
-agent_cli/agents/autocorrect.py,sha256=9odC5vNcAIZ_2IFmd8FN1x9gXrAv70HD0mxV0HiB2HU,8859
-agent_cli/agents/chat.py,sha256=QRCKh_GRIzivM0lH7i-_CBMjCTPR41tqk6TVQc10H4g,17142
-agent_cli/agents/rag_proxy.py,sha256=KboqLvSEAHn6iCCCA-dtrY67XSx30CXrHX9bcWWS6W0,4600
-agent_cli/agents/speak.py,sha256=yRrID1lp50XzhUwHBTmUzCNYCWlyy6MybMMCoxYtl3g,6994
-agent_cli/agents/transcribe.py,sha256=93-3OFgm9f0KWLIYXSptKY8TGu4t6xSv7r6BDwZ7ncA,24458
-agent_cli/agents/transcribe_daemon.py,sha256=mWjqqUTdTTSQn7_i8MFZ5SyoLpMu8Y3232jzQQmJVYI,17546
-agent_cli/agents/voice_edit.py,sha256=ovVhOQzWXBqFBZx23Odvv5-0PasxjeQwTccOcNat4RE,11022
-agent_cli/agents/memory/__init__.py,sha256=O-7ZPY5H-EV1lWy1LHTLeyXaortfWIzl3z_Ic4GcmTE,753
+agent_cli/agents/assistant.py,sha256=BMF693kUZxM7u7mcI0nVua0EpqFcGlby2cMMZeLT7hY,13965
+agent_cli/agents/autocorrect.py,sha256=R1ZftWDBXbdWCpJUz5JZnUx0u-9ceAJsOxx-yZWW2Ew,8892
+agent_cli/agents/chat.py,sha256=UVuCCb0vTOgKayDUeOfffRw_UeNykXpcQYa3WuWG64s,17176
+agent_cli/agents/rag_proxy.py,sha256=GuoPiQy3A6mgpYud-Ym5XQLRjA5d4cbvGCnnqxF968A,4627
+agent_cli/agents/speak.py,sha256=xTpY1hmAo4Z_5T1fZIJPTZz7tUbkQG12EYAMX_XsaRg,7027
+agent_cli/agents/transcribe.py,sha256=S-nO7hVRsDDO2P-WAIDXvqhdQT9lNKfw3nHjgZmhGxk,24492
+agent_cli/agents/transcribe_daemon.py,sha256=_xlOvNj7FACN9Yq6w-oXmnh5Iciv7ZiZcd-EamhwlWc,17580
+agent_cli/agents/voice_edit.py,sha256=Tcb5vRLIMs26vGBpTOhcg0lbCVUGfxwz1CS0o299_LM,11056
+agent_cli/agents/memory/__init__.py,sha256=gW-0NGksjxTKkSjk4PzlXZIiAoF0sS2mFrRdeGVITf8,780
 agent_cli/agents/memory/add.py,sha256=VkNd8es2llqTl4TdSAvXXz2G3BmIbWWvhXPwU5JrNnk,6135
 agent_cli/agents/memory/proxy.py,sha256=SC4aTv8EYM2e6UOnoU-9DFMUwiIK7PapLQc0IIcETbE,6550
 agent_cli/core/__init__.py,sha256=c_knH7u9QgjsfMIil9NP4bVizHawLUMYoQWU4H9vMlQ,46
@@ -37,10 +37,10 @@ agent_cli/core/utils.py,sha256=MHttXeGiM9qGUNxK0s6vAHthh033TDjaruqocdtMMFY,16802
 agent_cli/core/vad.py,sha256=67-EBjY-pTOf61VhrjVdDXgaNIBwWFFFccYth_1rQmg,6569
 agent_cli/core/watch.py,sha256=MKgGxxMe0yLlu78-XXqO4ferCpu_ljNr4MAzOMDsuuo,1951
 agent_cli/dev/__init__.py,sha256=doTYiUFEBpnOxsQA69HQP9AA4QHBN0DjuHSTGRq5Xbg,551
-agent_cli/dev/cli.py,sha256=NzYiIEYc_v7w2KEsSYGWOnNKSnXCaO6hihbfP5XKqJY,51192
+agent_cli/dev/cli.py,sha256=dQwLqrAwLUhg7iAFmlMfdMS60W-WjrWWDD01yxFqrpU,51223
 agent_cli/dev/project.py,sha256=wJMGKTK1rmw8letrV6l6wcLU1fkQQDjCSEixAnsvyaY,18971
 agent_cli/dev/registry.py,sha256=c6t3ClyRFPvU4GGXJT79-D-qV4FqY7W_7P-tLT7LKZs,1887
-agent_cli/dev/worktree.py,sha256=j0pZvoKDcCy9Jw_-L5DEM3Qk6NxqjwZ8uczT1ZK7rec,25476
+agent_cli/dev/worktree.py,sha256=Yw8jlhkf8BeKFc6pPEazGXnUIvryvYwbUmYxTluXILs,26916
 agent_cli/dev/coding_agents/__init__.py,sha256=f2SjWB7HwbiW0IDcJmGFFYal1-oNwBNEckdcni5Rf7s,360
 agent_cli/dev/coding_agents/aider.py,sha256=7iAZj7DG1E3nTw7cJxT05r5ZSzE8EWems1YRi1VpfLg,605
 agent_cli/dev/coding_agents/base.py,sha256=gMpSHItqjHITomVwHHPaxbZk6TDf0VbvZfVYtt5ptEo,5822
@@ -140,7 +140,7 @@ agent_cli/scripts/nvidia-asr-server/server.py,sha256=kPNQIVF3exblvqMtIVk38Y6sZy2
 agent_cli/scripts/nvidia-asr-server/shell.nix,sha256=IT20j5YNj_wc7MdXi7ndogGodDNSGwyq8G0bNoZEpmg,1003
 agent_cli/scripts/nvidia-asr-server/uv.lock,sha256=5WWaqWOuV_moMPC-LIZK-A-Y5oaHr1tUn_vbR-IupzY,728608
 agent_cli/server/__init__.py,sha256=NZuJHlLHck9KWrepNZHrJONptYCQI9P-uTqknSFI5Ds,71
-agent_cli/server/cli.py,sha256=8MSoRwpuc_UdU3bwkNcfQfxQvQvR0juTuEjR9C_3SJ0,22819
+agent_cli/server/cli.py,sha256=Oi-Ca54YusJijOp7TSl4a_9pOeIOKrgZE3Ex833ehis,22846
 agent_cli/server/common.py,sha256=fD2AZdM716TXcz1T4ZDPpPaKynVOEjbVC1LDDloDmDo,6463
 agent_cli/server/model_manager.py,sha256=93l_eeZeqnPALyDIK24or61tvded9TbM8tnde0okVjY,9225
 agent_cli/server/model_registry.py,sha256=KrRV1XxbFYuXu5rJlHFh6PTl_2BKiWnWsaNrf-0c6wQ,6988
@@ -172,8 +172,8 @@ agent_cli/services/asr.py,sha256=V6SV-USnMhK-0aE-pneiktU4HpmLqenmMb-jZ-_74zU,169
 agent_cli/services/llm.py,sha256=Kwdo6pbMYI9oykF-RBe1iaL3KsYrNWTLdRSioewmsGQ,7199
 agent_cli/services/tts.py,sha256=exKo-55_670mx8dQOzVSZkv6aWYLv04SVmBcjOlD458,14772
 agent_cli/services/wake_word.py,sha256=j6Z8rsGq_vAdRevy9fkXIgLZd9UWfrIsefmTreNmM0c,4575
-agent_cli-0.61.5.dist-info/METADATA,sha256=WxLELZ247ybi-yyN25vZkJCEG5MpiGMx7KvXiOXNvoo,151903
-agent_cli-0.61.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-agent_cli-0.61.5.dist-info/entry_points.txt,sha256=FUv-fB2atLsPUk_RT4zqnZl1coz4_XHFwRALOKOF38s,97
-agent_cli-0.61.5.dist-info/licenses/LICENSE,sha256=majJU6S9kC8R8bW39NVBHyv32Dq50FL6TDxECG2WVts,1068
-agent_cli-0.61.5.dist-info/RECORD,,
+agent_cli-0.62.0.dist-info/METADATA,sha256=9NRk688EZxkuThkRJOahxw-ZH6Y2yQsVHuYMpK5Qm2A,151909
+agent_cli-0.62.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agent_cli-0.62.0.dist-info/entry_points.txt,sha256=FUv-fB2atLsPUk_RT4zqnZl1coz4_XHFwRALOKOF38s,97
+agent_cli-0.62.0.dist-info/licenses/LICENSE,sha256=majJU6S9kC8R8bW39NVBHyv32Dq50FL6TDxECG2WVts,1068
+agent_cli-0.62.0.dist-info/RECORD,,