agent-cli 0.102.2__tar.gz → 0.102.3__tar.gz

{agent_cli-0.102.2 → agent_cli-0.102.3}/.github/workflows/docs.yml

@@ -32,7 +32,7 @@ jobs:
           lfs: true
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.3.2
+        uses: astral-sh/setup-uv@v9.0.0
 
       - name: Set up Python
         run: uv python install 3.12

{agent_cli-0.102.2 → agent_cli-0.102.3}/.github/workflows/markdown-code-runner.yml

@@ -17,12 +17,12 @@ jobs:
           fetch-depth: 0
 
       - name: Set up Python
-        uses: actions/setup-python@v6.3.0
+        uses: actions/setup-python@v7.0.0
         with:
           python-version: "3.13.11"
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.3.2
+        uses: astral-sh/setup-uv@v9.0.0
 
       - name: Run markdown-code-runner
         env:

{agent_cli-0.102.2 → agent_cli-0.102.3}/.github/workflows/pytest.yml

@@ -20,14 +20,14 @@ jobs:
     steps:
       - uses: actions/checkout@v7.0.1
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6.3.0
+        uses: actions/setup-python@v7.0.0
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install portaudio (Linux only)
         if: matrix.os == 'ubuntu-latest'
         run: sudo apt-get update && sudo apt-get install -y portaudio19-dev
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.3.2
+        uses: astral-sh/setup-uv@v9.0.0
       - name: Run macOS app Swift tests
         if: matrix.os == 'macos-latest' && matrix.python-version == '3.13'
         run: swift test --package-path macos/AgentCLI --enable-xctest

{agent_cli-0.102.2 → agent_cli-0.102.3}/.github/workflows/release.yml

@@ -16,7 +16,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7.0.1
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.3.2
+        uses: astral-sh/setup-uv@v9.0.0
       - name: Build
         run: uv build
       - name: Publish package distributions to PyPI
@@ -31,7 +31,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7.0.1
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.3.2
+        uses: astral-sh/setup-uv@v9.0.0
       - name: Import Developer ID certificate
         uses: apple-actions/import-codesign-certs@v7.0.0
         with:

{agent_cli-0.102.2 → agent_cli-0.102.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.102.2
+Version: 0.102.3
 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.102.2 → agent_cli-0.102.3}/agent_cli/config.py

@@ -316,7 +316,7 @@ class Dev(BaseModel):
     )
     agent_env: dict[str, dict[str, str]] | None = None
     setup: bool = True  # Run project setup (npm install, etc.)
-    copy_env: bool = True  # Copy .env files from main repo
+    copy_env: bool = True  # Copy env and local agent instruction files from main repo
     fetch: bool = True  # Git fetch before creating worktree
 
 

{agent_cli-0.102.2 → agent_cli-0.102.3}/agent_cli/dev/cli.py

@@ -290,12 +290,12 @@ def _setup_worktree_env(
     direnv: bool | None,
     verbose: bool,
 ) -> None:
-    """Copy env files, run project setup, and configure direnv."""
+    """Copy local setup files, run project setup, and configure direnv."""
     if copy_env:
         copied = copy_env_files(repo_root, worktree_path)
         if copied:
             names = ", ".join(f.name for f in copied)
-            success(f"Copied env file(s): {names}")
+            success(f"Copied local setup file(s): {names}")
 
     project = None
     if setup:
@@ -413,7 +413,7 @@ def new(
         bool,
         typer.Option(
             "--copy-env/--no-copy-env",
-            help="Copy .env, .env.local, .env.example from main repo to worktree",
+            help="Copy env and local agent instruction files from main repo to worktree",
         ),
     ] = True,
     fetch: Annotated[
@@ -525,7 +525,7 @@ def new(
     **What happens:**
 
     1. Creates git worktree at `../REPO-worktrees/BRANCH/`
-    2. Copies .env files from main repo (--copy-env)
+    2. Copies env and local agent instruction files from main repo (--copy-env)
     3. Runs project setup: npm install, uv sync, etc. (--setup)
     4. Sets up direnv if installed (--direnv)
     5. Opens editor if requested (-e/--editor)

{agent_cli-0.102.2 → agent_cli-0.102.3}/agent_cli/dev/project.py

@@ -12,6 +12,8 @@ if TYPE_CHECKING:
     from collections.abc import Callable
     from pathlib import Path
 
+_LOCAL_AGENT_INSTRUCTION_FILES = ("AGENTS.local.md", "CLAUDE.local.md")
+
 
 @dataclass
 class ProjectType:
@@ -366,6 +368,7 @@ def copy_env_files(
             ".env.local",
             ".env.example",
             ".envrc",
+            *_LOCAL_AGENT_INSTRUCTION_FILES,
         ]
 
     copied: list[Path] = []
@@ -380,7 +383,12 @@ def copy_env_files(
 
         for src_file in source_files:
             if src_file.is_file():
-                dest_file = dest / src_file.relative_to(source)
+                relative_path = src_file.relative_to(source)
+                dest_file = dest / relative_path
+                if relative_path.as_posix() in _LOCAL_AGENT_INSTRUCTION_FILES and os.path.lexists(
+                    dest_file
+                ):
+                    continue
                 dest_file.parent.mkdir(parents=True, exist_ok=True)
                 dest_file.write_bytes(src_file.read_bytes())
                 copied.append(dest_file)

{agent_cli-0.102.2 → agent_cli-0.102.3}/docs/commands/dev.md

@@ -78,7 +78,7 @@ agent-cli dev new [BRANCH] [OPTIONS]
 | `--agent` | - | Which AI agent to start: claude, codex, gemini, aider, copilot, cn (Continue), opencode, cursor-agent, or auto. Implies starting the agent |
 | `--with-editor` | - | Which editor to open: cursor, vscode, zed, nvim, vim, emacs, sublime, idea, pycharm, etc. |
 | `--setup/--no-setup` | `true` | Run project setup after creation: npm/pnpm/yarn install, poetry/uv sync, cargo build, etc. Auto-detects project type |
-| `--copy-env/--no-copy-env` | `true` | Copy .env, .env.local, .env.example from main repo to worktree |
+| `--copy-env/--no-copy-env` | `true` | Copy env and local agent instruction files from main repo to worktree |
 | `--fetch/--no-fetch` | `true` | Run 'git fetch' before creating the worktree to ensure refs are up-to-date |
 | `--branch-name-mode` | `random` | How to auto-name branches when BRANCH is omitted: random (default), auto (AI only when --prompt/--prompt-file is set), or ai (always try AI first) |
 | `--branch-name-agent` | - | Headless agent for AI branch naming: claude, codex, or gemini. If omitted, uses --agent when supported, otherwise tries available agents in that order |
@@ -606,7 +606,7 @@ direnv = true          # Always generate .envrc (--direnv)
 
 # Worktree creation behavior
 setup = true           # Run project setup (npm install, etc.)
-copy_env = true        # Copy .env files from main repo
+copy_env = true        # Copy env and local agent instruction files
 fetch = true           # Git fetch before creating
 
 # Branch naming behavior when BRANCH argument is omitted
@@ -702,7 +702,7 @@ git lfs pull
 
 This ensures large files tracked by LFS are available in the worktree.
 
-### Environment Files
+### Local Setup Files
 
 The following files are automatically copied to new dev environments:
 
@@ -710,6 +710,11 @@ The following files are automatically copied to new dev environments:
 - `.env.local`
 - `.env.example`
 - `.envrc`
+- `AGENTS.local.md`
+- `CLAUDE.local.md`
+
+If the target branch already contains either local agent instruction file,
+its checked-out version is preserved.
 
 Use `--no-copy-env` to skip this.
 

{agent_cli-0.102.2 → agent_cli-0.102.3}/macos/appcast.xml

@@ -4,6 +4,28 @@
         <title>Agent CLI Updates</title>
         <link>https://github.com/basnijholt/agent-cli</link>
         <description>Signed Agent CLI macOS app updates.</description>
+        <item>
+            <title>0.102.2</title>
+            <pubDate>Sat, 25 Jul 2026 20:18:46 +0000</pubDate>
+            <link>https://github.com/basnijholt/agent-cli</link>
+            <sparkle:version>199</sparkle:version>
+            <sparkle:shortVersionString>0.102.2</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
+            <sparkle:hardwareRequirements>arm64</sparkle:hardwareRequirements>
+            <description sparkle:format="markdown"><![CDATA[## Bug fixes
+
+- **MLX Whisper: stop unbounded memory growth under `--ttl 0`** (#620). The long-lived transcription subprocess never released MLX's reusable Metal buffer cache, so it ratcheted up to the largest working set ever seen and eventually got pushed to swap — one deployment reached a 17.1 GB physical footprint for a 2.9 GB model, with a 5.2s clip degrading from ~2.0s to ~5.2s. The backend now calls `mx.clear_cache()` after each request, including on failure. Only the reusable cache is freed, not live arrays, so model weights stay resident and inference stays hot; measured cost is ~7.6 ms per request (~0.3%).
+
+- **Require `mlx>=0.24` for the `mlx-whisper` extra** (#620). The top-level `mx.clear_cache()` does not exist before mlx 0.24 — 0.23.2 and older only expose the deprecated `mx.metal.clear_cache()` — and `mlx-whisper` itself only requires `mlx>=0.11`. Without the floor, an environment resolving an older mlx would raise `AttributeError` on every transcription.
+
+## Internal
+
+- Pin `uv` in the `uv-lock` and `sync-requirements` pre-commit hooks so the generated `agent_cli/_requirements/*.txt` files depend on the config rather than on how fresh each contributor's hook cache is (#620).
+- Render the shared consoles without colour during tests (#625).
+- Drop the broken Homebrew tap dispatch from the release workflow (#623).
+]]></description>
+            <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.102.2/AgentCLI.zip" length="24329779" type="application/octet-stream" sparkle:edSignature="CeWZFIPSDJSiO8iQbm46QDRet3IYvIvgL4qSyYdDmwlTlkhV66IaXp05Wt04+xLBKTJcAv9333tA9n8BZ9IvBQ=="/>
+        </item>
         <item>
             <title>0.102.1</title>
             <pubDate>Sat, 25 Jul 2026 18:58:28 +0000</pubDate>
@@ -175,20 +197,5 @@
 ]]></description>
             <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.98.2/AgentCLI.zip" length="22896370" type="application/octet-stream" sparkle:edSignature="2yWD4AB0k4GCxWKbXVysPQ5Hy0ehhW9XYlLHTipGwOCscaa+ZDVvlzM2WQtQ1EHDIsMR07loArT6PGKbXyyEBg=="/>
         </item>
-        <item>
-            <title>0.98.1</title>
-            <pubDate>Thu, 04 Jun 2026 16:50:48 +0000</pubDate>
-            <link>https://github.com/basnijholt/agent-cli</link>
-            <sparkle:version>189</sparkle:version>
-            <sparkle:shortVersionString>0.98.1</sparkle:shortVersionString>
-            <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
-            <sparkle:hardwareRequirements>arm64</sparkle:hardwareRequirements>
-            <description sparkle:format="markdown"><![CDATA[## What’s Changed
-
-* Add macOS transcription TTL setting (#578) @basnijholt
-
-]]></description>
-            <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.98.1/AgentCLI.zip" length="22896191" type="application/octet-stream" sparkle:edSignature="4g9PD/is1i4Htq5eM2TfAUjxEaXSb7xJJDjnliSfX5TQfqeLLsItUcaCLbhpXaOKqzq0YByVg5SLSpqHK08vAw=="/>
-        </item>
     </channel>
 </rss>

{agent_cli-0.102.2 → agent_cli-0.102.3}/tests/dev/test_project.py

@@ -534,6 +534,66 @@ class TestCopyEnvFiles:
         copied = copy_env_files(source, dest)
         assert len(copied) == 2
 
+    def test_copy_local_agent_instruction_files(self, tmp_path: Path) -> None:
+        """Copy local agent instruction files."""
+        source = tmp_path / "source"
+        dest = tmp_path / "dest"
+        source.mkdir()
+        dest.mkdir()
+        files = {
+            "AGENTS.local.md": "Use pytest.\n",
+            "CLAUDE.local.md": "Use ruff.\n",
+        }
+        for name, content in files.items():
+            (source / name).write_text(content)
+
+        copied = copy_env_files(source, dest)
+
+        assert {path.name for path in copied} == set(files)
+        for name, content in files.items():
+            assert (dest / name).read_text() == content
+
+    @pytest.mark.parametrize("name", ["AGENTS.local.md", "CLAUDE.local.md"])
+    def test_preserve_existing_local_agent_instruction_file(
+        self,
+        tmp_path: Path,
+        name: str,
+    ) -> None:
+        """Preserve local agent instructions checked out by the target branch."""
+        source = tmp_path / "source"
+        dest = tmp_path / "dest"
+        source.mkdir()
+        dest.mkdir()
+        (source / name).write_text("main worktree instructions\n")
+        (dest / name).write_text("target branch instructions\n")
+
+        copied = copy_env_files(source, dest)
+
+        assert copied == []
+        assert (dest / name).read_text() == "target branch instructions\n"
+
+    def test_preserve_dangling_local_agent_instruction_symlink(
+        self,
+        tmp_path: Path,
+    ) -> None:
+        """Preserve a dangling instruction symlink checked out by the target branch."""
+        source = tmp_path / "source"
+        dest = tmp_path / "dest"
+        source.mkdir()
+        dest.mkdir()
+        (source / "AGENTS.local.md").write_text("main worktree instructions\n")
+        dest_file = dest / "AGENTS.local.md"
+        try:
+            dest_file.symlink_to("missing-instructions.md")
+        except OSError as exc:
+            pytest.skip(f"Symlinks unavailable: {exc}")
+
+        copied = copy_env_files(source, dest)
+
+        assert copied == []
+        assert dest_file.is_symlink()
+        assert not (dest / "missing-instructions.md").exists()
+
     def test_skip_missing_files(self, tmp_path: Path) -> None:
         """Skip files that don't exist."""
         source = tmp_path / "source"