agent-cli 0.94.2__tar.gz → 0.95.0__tar.gz

agent_cli-0.95.0/.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/${{ github.repository }}
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+      - name: Build
+        run: uv build
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  build_macos_app:
+    runs-on: macos-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+      - name: Import Developer ID certificate
+        uses: apple-actions/import-codesign-certs@v7
+        with:
+          p12-file-base64: ${{ secrets.MACOS_CODESIGN_CERTIFICATE_BASE64 }}
+          p12-password: ${{ secrets.MACOS_CODESIGN_CERTIFICATE_PASSWORD }}
+          keychain-password: ${{ secrets.MACOS_KEYCHAIN_PASSWORD }}
+      - name: Resolve Developer ID identity
+        id: codesign
+        run: |
+          IDENTITY=$(
+            security find-identity -v -p codesigning |
+              awk -F '"' '/Developer ID Application/ { print $2; exit }'
+          )
+          if [[ -z "$IDENTITY" ]]; then
+            echo "Developer ID Application signing identity not found." >&2
+            exit 1
+          fi
+          echo "identity=$IDENTITY" >> "$GITHUB_OUTPUT"
+      - name: Build notarized macOS DMG
+        env:
+          CODESIGN_IDENTITY: ${{ steps.codesign.outputs.identity }}
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+        run: NOTARIZE=1 macos/build-macos-app.sh --dmg
+      - name: Upload macOS app to GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ github.event.release.tag_name }}
+        run: gh release upload "$TAG_NAME" dist/macos/AgentCLI.dmg --clobber

{agent_cli-0.94.2 → agent_cli-0.95.0}/.gitignore

@@ -7,6 +7,7 @@ __pycache__/
 *$py.class
 *.so
 .Python
+.build/
 build/
 develop-eggs/
 dist/

{agent_cli-0.94.2 → agent_cli-0.95.0}/.pre-commit-config.yaml

@@ -11,7 +11,7 @@ repos:
       - id: end-of-file-fixer
       - id: mixed-line-ending
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.15.13"
+    rev: "v0.15.14"
     hooks:
       - id: ruff
         args: ["--fix"]

{agent_cli-0.94.2 → agent_cli-0.95.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.94.2
+Version: 0.95.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.94.2 → agent_cli-0.95.0}/agent_cli/core/process.py

@@ -2,24 +2,49 @@
 
 from __future__ import annotations
 
+import json
 import os
 import signal
 import sys
+import tempfile
 import time
 from contextlib import contextmanager
 from pathlib import Path
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, NamedTuple
 
 if TYPE_CHECKING:
     from collections.abc import Generator
 
-# Default location for PID files
-PID_DIR = Path.home() / ".cache" / "agent-cli"
-
 # Store the original process title before any modifications
 _original_proctitle: str | None = None
 
 
+class _PidInfo(NamedTuple):
+    pid: int
+    uses_lock: bool
+
+
+def _default_pid_dir() -> Path:
+    """Return local runtime dir for process control files."""
+    if runtime_dir := os.environ.get("AGENTCLI_RUNTIME_DIR"):
+        return Path(runtime_dir)
+
+    if xdg_runtime_dir := os.environ.get("XDG_RUNTIME_DIR"):
+        return Path(xdg_runtime_dir) / "agent-cli"
+
+    if os.name == "posix":
+        return Path(tempfile.gettempdir()) / f"agent-cli-{os.getuid()}"
+
+    if local_app_data := os.environ.get("LOCALAPPDATA"):
+        return Path(local_app_data) / "agent-cli" / "runtime"
+
+    return Path(tempfile.gettempdir()) / "agent-cli-runtime"
+
+
+# Default location for PID files and process locks.
+PID_DIR = _default_pid_dir()
+
+
 def set_process_title(process_name: str) -> None:
     """Set the process title and thread name for identification in ps/htop/btop.
 
@@ -57,6 +82,12 @@ def _get_pid_file(process_name: str) -> Path:
     return PID_DIR / f"{process_name}.pid"
 
 
+def _get_lock_file(process_name: str) -> Path:
+    """Get the path to the process lock file for a given process name."""
+    PID_DIR.mkdir(parents=True, exist_ok=True)
+    return PID_DIR / f"{process_name}.lock"
+
+
 def _get_stop_file(process_name: str) -> Path:
     """Get the path to the stop file for a given process name."""
     PID_DIR.mkdir(parents=True, exist_ok=True)
@@ -89,28 +120,137 @@ def _is_pid_running(pid: int) -> bool:
         return False
 
 
-def _get_running_pid(process_name: str) -> int | None:
-    """Get PID if process is running, None otherwise. Cleans up stale files."""
-    pid_file = _get_pid_file(process_name)
+def _supports_process_locks() -> bool:
+    """Return whether this platform supports POSIX advisory locks."""
+    return sys.platform != "win32"
 
-    if not pid_file.exists():
+
+def _acquire_process_lock(process_name: str) -> int | None:
+    """Try to acquire the per-process lock. Return fd when held."""
+    if not _supports_process_locks():
+        return None
+
+    import fcntl  # noqa: PLC0415
+
+    lock_file = _get_lock_file(process_name)
+    fd = os.open(lock_file, os.O_CREAT | os.O_RDWR, 0o600)
+    try:
+        fcntl.flock(fd, fcntl.LOCK_EX | fcntl.LOCK_NB)
+    except BlockingIOError:
+        os.close(fd)
+        return None
+    except OSError:
+        os.close(fd)
+        raise
+    return fd
+
+
+def _release_process_lock(lock_fd: int | None) -> None:
+    """Release a lock fd returned by _acquire_process_lock."""
+    if lock_fd is None:
+        return
+
+    import fcntl  # noqa: PLC0415
+
+    fcntl.flock(lock_fd, fcntl.LOCK_UN)
+    os.close(lock_fd)
+
+
+def _is_process_lock_held(process_name: str) -> bool:
+    """Return True when another process still owns the lock."""
+    if not _supports_process_locks():
+        return True
+
+    lock_fd = _acquire_process_lock(process_name)
+    if lock_fd is None:
+        return True
+
+    _release_process_lock(lock_fd)
+    return False
+
+
+def _legacy_pid_info(raw: str) -> _PidInfo | None:
+    """Parse a legacy numeric PID file."""
+    try:
+        return _PidInfo(pid=int(raw), uses_lock=False)
+    except ValueError:
+        return None
+
+
+def _pid_info_from_payload(process_name: str, payload: object) -> _PidInfo | None:
+    """Parse JSON PID metadata."""
+    if isinstance(payload, int):
+        return _PidInfo(pid=payload, uses_lock=False)
+
+    if (
+        not isinstance(payload, dict)
+        or payload.get("version") != 1
+        or payload.get("process_name") != process_name
+    ):
+        return None
+
+    try:
+        pid = int(payload["pid"])
+    except (KeyError, TypeError, ValueError):
+        return None
+
+    return _PidInfo(pid=pid, uses_lock=True)
+
+
+def _read_pid_info(process_name: str) -> _PidInfo | None:
+    """Read either current JSON PID metadata or a legacy numeric PID file."""
+    pid_file = _get_pid_file(process_name)
+    try:
+        raw = pid_file.read_text().strip()
+    except FileNotFoundError:
         return None
 
     try:
-        with pid_file.open() as f:
-            pid = int(f.read().strip())
+        payload = json.loads(raw)
+    except json.JSONDecodeError:
+        return _legacy_pid_info(raw)
 
-        # Check if process is actually running
-        if _is_pid_running(pid):
-            return pid
+    return _pid_info_from_payload(process_name, payload)
 
-    except (FileNotFoundError, ValueError):
-        pass
 
-    # Clean up stale/invalid PID file
+def _write_pid_info(process_name: str) -> None:
+    """Write PID metadata for the current process."""
+    pid_file = _get_pid_file(process_name)
+    payload = {
+        "version": 1,
+        "process_name": process_name,
+        "pid": os.getpid(),
+        "created_at": time.time(),
+    }
+    pid_file.write_text(json.dumps(payload, sort_keys=True))
+
+
+def _cleanup_process_files(process_name: str) -> None:
+    """Remove stale process control files."""
+    pid_file = _get_pid_file(process_name)
     if pid_file.exists():
         pid_file.unlink()
     clear_stop_file(process_name)
+
+
+def _get_running_pid(process_name: str) -> int | None:
+    """Get PID if process is running, None otherwise. Cleans up stale files."""
+    if not _get_pid_file(process_name).exists():
+        return None
+
+    pid_info = _read_pid_info(process_name)
+    if pid_info is None:
+        _cleanup_process_files(process_name)
+        return None
+
+    if pid_info.uses_lock and _supports_process_locks() and not _is_process_lock_held(process_name):
+        _cleanup_process_files(process_name)
+        return None
+
+    if _is_pid_running(pid_info.pid):
+        return pid_info.pid
+
+    _cleanup_process_files(process_name)
     return None
 
 
@@ -173,9 +313,7 @@ def kill_process(process_name: str) -> bool:
     # Keep PID file if process is still alive so subsequent --status/--toggle
     # calls continue targeting the same process.
     if process_stopped:
-        clear_stop_file(process_name)
-        if pid_file.exists():
-            pid_file.unlink()
+        _cleanup_process_files(process_name)
     elif not should_force_kill:
         stop_file.touch()
 
@@ -189,21 +327,33 @@ def pid_file_context(process_name: str) -> Generator[Path, None, None]:
     Creates PID file on entry, cleans up on exit.
     Exits with error if process already running.
     """
-    if is_process_running(process_name):
+    lock_fd = _acquire_process_lock(process_name)
+    if _supports_process_locks() and lock_fd is None:
         existing_pid = _get_running_pid(process_name)
         print(f"Process {process_name} is already running (PID: {existing_pid})")
         sys.exit(1)
 
+    if not _supports_process_locks() and is_process_running(process_name):
+        existing_pid = _get_running_pid(process_name)
+        print(f"Process {process_name} is already running (PID: {existing_pid})")
+        sys.exit(1)
+
+    if _supports_process_locks():
+        pid_info = _read_pid_info(process_name)
+        if pid_info and not pid_info.uses_lock and _is_pid_running(pid_info.pid):
+            _release_process_lock(lock_fd)
+            print(f"Process {process_name} is already running (PID: {pid_info.pid})")
+            sys.exit(1)
+        _cleanup_process_files(process_name)
+
     # Clear stale stop markers from previous runs.
     clear_stop_file(process_name)
 
     pid_file = _get_pid_file(process_name)
-    with pid_file.open("w") as f:
-        f.write(str(os.getpid()))
+    _write_pid_info(process_name)
 
     try:
         yield pid_file
     finally:
-        if pid_file.exists():
-            pid_file.unlink()
-        clear_stop_file(process_name)
+        _cleanup_process_files(process_name)
+        _release_process_lock(lock_fd)

{agent_cli-0.94.2 → agent_cli-0.95.0}/agent_cli/daemon/cli.py

@@ -146,9 +146,11 @@ def status_cmd(
     console.print()
     system = platform.system()
     if system == "Darwin":
-        console.print("[dim]Full logs: ~/Library/Logs/agent-cli-<service>/[/dim]")
+        log_service = service or "<service>"
+        console.print(f"[dim]Full logs: ~/Library/Logs/agent-cli-{log_service}/[/dim]")
     else:
-        console.print("[dim]Full logs: journalctl --user -u agent-cli-<service> -f[/dim]")
+        log_service = service or "<service>"
+        console.print(f"[dim]Full logs: journalctl --user -u agent-cli-{log_service} -f[/dim]")
 
 
 def _confirm_action(message: str) -> bool:

{agent_cli-0.94.2 → agent_cli-0.95.0}/agent_cli/install/launchd.py

@@ -41,6 +41,22 @@ _MACOS_DAEMON_PATH = (
     "/sbin"
 )
 
+_PRESERVED_APP_ENV_KEYS = (
+    "AGENTCLI_APP_SUPPORT_DIR",
+    "AGENTCLI_BUNDLED_UV",
+    "AGENTCLI_PACKAGE_SOURCE",
+    "AGENTCLI_RUNTIME_DIR",
+    "AGENT_CLI_CONFIG_HOME",
+    "UV_CACHE_DIR",
+    "UV_PYTHON_INSTALL_DIR",
+    "UV_PYTHON_BIN_DIR",
+    "UV_TOOL_DIR",
+    "UV_TOOL_BIN_DIR",
+    "UV_NO_PROGRESS",
+    "NO_COLOR",
+    "TERM",
+)
+
 
 def _get_label(service_name: str) -> str:
     """Get launchd label for a service."""
@@ -95,13 +111,19 @@ def _generate_plist(
     log_dir: Path,
 ) -> dict:
     """Generate plist dictionary for a launchd service."""
+    environment = {"PATH": _MACOS_DAEMON_PATH}
+    for key in _PRESERVED_APP_ENV_KEYS:
+        value = os.environ.get(key)
+        if value:
+            environment[key] = value
+
     return {
         "Label": _get_label(service.name),
         "ProgramArguments": build_service_command(service, uv_path, use_macos_extra=True),
         "RunAtLoad": True,
         "KeepAlive": True,
         "WorkingDirectory": str(home_dir),
-        "EnvironmentVariables": {"PATH": _MACOS_DAEMON_PATH},
+        "EnvironmentVariables": environment,
         "StandardOutPath": str(log_dir / "stdout.log"),
         "StandardErrorPath": str(log_dir / "stderr.log"),
     }

{agent_cli-0.94.2 → agent_cli-0.95.0}/agent_cli/install/service_config.py

@@ -126,6 +126,7 @@ def build_service_command(
 ) -> list[str]:
     """Build the command args for running a service via uv tool run."""
     extra = (service.macos_extra or service.extra) if use_macos_extra else service.extra
+    package_source = os.environ.get("AGENTCLI_PACKAGE_SOURCE", "agent-cli")
 
     args = [str(uv_path), "tool", "run"]
 
@@ -140,7 +141,7 @@ def build_service_command(
     args.extend(
         [
             "--from",
-            f"agent-cli[{extra}]",
+            f"{package_source}[{extra}]",
             "agent-cli",
             *cmd_path,
             *service.command_args,
@@ -151,6 +152,12 @@ def build_service_command(
 
 def find_uv(extra_paths: list[Path] | None = None) -> Path | None:
     """Find uv executable, preferring system paths over virtualenv."""
+    bundled_uv = os.environ.get("AGENTCLI_BUNDLED_UV")
+    if bundled_uv:
+        bundled_uv_path = Path(bundled_uv).expanduser()
+        if bundled_uv_path.is_file() and os.access(bundled_uv_path, os.X_OK):
+            return bundled_uv_path
+
     paths = [
         Path.home() / ".local" / "bin" / "uv",
         Path.home() / ".cargo" / "bin" / "uv",

agent_cli-0.95.0/docs/logo-avatar.svg

@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg
+   version="1.1"
+   width="790"
+   height="850"
+   viewBox="560 140 790 850"
+   xmlns="http://www.w3.org/2000/svg">
+  <title>AgentCLI avatar logo</title>
+  <path
+     fill="#000000"
+     opacity="1"
+     stroke="none"
+     d="m 1209.8213,729.78601 c -7.9569,6.79279 -15.6414,13.35761 -24.1472,20.62415 2.4815,0.82159 4.0852,1.40344 5.7182,1.88562 27.5103,8.12365 53.4462,19.46124 76.1413,37.37982 22.0362,17.39838 37.714,39.23993 45.8825,66.23254 2.2857,7.55261 1.4493,8.7218 -5.6893,11.61774 -30.7659,12.48059 -63.024,19.94079 -94.9846,28.41571 -46.2448,12.26251 -92.4716,24.59228 -138.709,36.88257 -47.6999,12.67908 -95.39959,25.35937 -143.11419,37.98364 -3.03717,0.80353 -6.18586,1.2497 -9.31031,1.64197 -3.49304,0.43854 -4.9248,-1.21564 -5.40039,-4.7956 -1.48095,-11.14703 3.90241,-19.78723 10.24933,-27.76794 20.61048,-25.91571 41.63898,-51.49847 62.33527,-77.3465 26.10899,-32.60809 52.35859,-65.11145 77.95039,-98.12286 16.1009,-20.76886 31.6269,-42.03064 46.4675,-63.71686 17.0558,-24.92303 30.0562,-52.13397 41.9342,-79.8595 3.9229,-9.15649 7.5886,-18.43768 11.8917,-27.41272 4.7139,-9.83203 11.151,-11.95098 20.148,-5.74469 13.6746,9.43311 26.9023,19.54426 39.9952,29.7826 16.5074,12.90838 32.8511,26.03937 48.9367,39.46814 7.3025,6.09649 7.2936,9.74573 0.068,16.27643 -13.8256,12.49688 -28.0118,24.59881 -42.1773,36.71392 -7.8365,6.70221 -15.9341,13.09925 -24.1865,19.86182 z"
+     id="path3" />
+  <path
+     fill="#000000"
+     opacity="1"
+     stroke="none"
+     d="m 919.20166,914.198 c -8.34613,9.74634 -16.54401,19.15252 -24.56738,28.7052 -3.1305,3.72729 -6.66651,4.19189 -11.1416,2.99115 -31.12769,-8.35242 -62.30451,-16.52124 -93.44202,-24.83698 -54.37109,-14.52063 -108.74457,-29.03308 -163.07025,-43.72229 -10.90027,-2.94732 -21.62348,-6.57 -32.36756,-10.06799 -6.63604,-2.16052 -7.72589,-4.2674 -5.47186,-11.24902 4.96222,-15.3703 12.83722,-29.18225 22.99591,-41.72339 21.67182,-26.75434 50.24958,-43.17896 82.03174,-54.73816 7.96643,-2.8974 16.13458,-5.23908 24.20068,-7.86469 1.20649,-0.39264 2.36176,-0.94238 3.89765,-1.56384 -8.9422,-7.60107 -17.4596,-14.91577 -26.05805,-22.13379 -16.05511,-13.47766 -32.18499,-26.86639 -48.22418,-40.36291 -5.21435,-4.38788 -10.51117,-8.7323 -15.28278,-13.57685 -5.00396,-5.08038 -5.14495,-9.46136 0.15265,-14.20929 9.76905,-8.75549 19.85767,-17.19793 30.24573,-25.2099 20.02075,-15.44146 40.26221,-30.60095 60.57636,-45.65582 9.14526,-6.77759 14.12945,-5.98553 19.99621,3.84906 3.79395,6.35986 6.33795,13.5354 8.91535,20.53931 16.68872,45.35052 39.8966,87.14245 69.03344,125.59143 35.77009,47.20227 71.89661,94.13476 107.96442,141.11065 6.99518,9.11078 7.1795,11.85956 -0.0228,20.87726 -3.42492,4.28821 -6.76507,8.64411 -10.36169,13.25086 z"
+     id="path4" />
+  <path
+     fill="#000000"
+     opacity="1"
+     stroke="none"
+     d="m 767.73248,321.60425 c 12.22571,-38.65079 25.76428,-76.81659 43.87549,-113.15615 4.40894,-8.84637 10.00739,-17.25793 16.07678,-25.07946 7.92694,-10.21523 20.30701,-13.11473 32.78595,-7.45446 22.24073,10.08811 44.2439,20.72582 66.07392,31.67688 6.16131,3.09084 11.12243,2.94316 17.26513,0.23487 25.19458,-11.10825 50.32831,-22.45487 76.05375,-32.21324 11.5618,-4.38572 24.3671,-6.31911 36.7803,-7.41323 13.678,-1.20563 24.5903,5.39716 32.5616,16.71669 10.3904,14.75437 16.1661,31.58501 21.9972,48.38257 10.1316,29.18511 20.127,58.41744 30.0826,88.44579 0.5645,5.70669 -1.6925,8.66787 -5.7422,11.3908 -11.8971,7.99949 -24.9334,13.10071 -38.6563,16.84739 -33.4929,9.14441 -67.85,12.13235 -102.29912,13.76477 -21.05755,0.99786 -42.22357,0.93478 -63.29321,0.11816 -23.01959,-0.89218 -46.00232,-2.99112 -68.96747,-4.95709 -22.06115,-1.88855 -43.73883,-6.12631 -64.45574,-14.02503 -12.19141,-4.64816 -25.73176,-8.25018 -30.13868,-23.27926 z"
+     id="path5" />
+  <path
+     fill="#000000"
+     opacity="1"
+     stroke="none"
+     d="m 780.65991,591.28064 c -8.93969,-15.16431 -16.72259,-30.4505 -17.67706,-48.07752 -0.70624,-13.04443 1.43805,-25.83831 5.35516,-38.28729 1.83551,-5.83356 6.9112,-7.84854 12.18225,-7.87164 21.81403,-0.0957 43.63489,0.0438 65.44336,0.53665 12.11969,0.2739 24.23218,1.25513 36.3252,2.20691 13.40527,1.05502 26.5636,2.92807 39.41986,7.64346 6.53088,2.39536 14.24194,1.77881 21.43842,2.10099 8.76715,0.39251 17.55474,0.45828 26.33245,0.42224 3.53882,-0.0145 7.53003,0.26034 10.53217,-1.20313 11.93207,-5.81671 24.67548,-8.24005 37.61398,-8.80978 32.7459,-1.44199 65.518,-2.39148 98.2891,-3.11643 19.5583,-0.43261 21.89,2.60971 25.7073,21.76041 5.997,30.0871 -2.0799,56.40057 -20.2144,79.97858 -12.831,16.68255 -30.8633,24.56946 -51.4877,27.30462 -15.1449,2.00855 -29.8342,0.52857 -44.1062,-4.67456 -19.6779,-7.17413 -33.22988,-21.24896 -42.25514,-39.64483 -4.74561,-9.67267 -8.42908,-19.90833 -12.01215,-30.09381 -2.16852,-6.16437 -5.79596,-10.39124 -12.19409,-10.88709 -6.02869,-0.46735 -12.21552,-0.13769 -18.21436,0.69476 -3.93243,0.54572 -5.50775,4.15528 -6.65497,7.92743 -4.79638,15.77075 -9.63128,31.5492 -19.29608,45.26361 -12.99487,18.43982 -30.43359,29.05353 -53.08533,31.4917 -20.75683,2.23407 -39.99859,-1.72113 -57.96875,-12.1109 -9.53326,-5.51202 -17.07849,-13.20111 -23.47302,-22.55438 z"
+     id="path6" />
+  <path
+     fill="#000000"
+     opacity="1"
+     stroke="none"
+     d="m 1159.632,371.56082 c 12.5134,3.14069 25.1529,5.85529 37.5131,9.51379 23.2758,6.88944 46.2019,14.83405 67.7437,26.22648 4.0902,2.16308 8.0398,4.76977 11.6025,7.71753 8.7958,7.2774 8.166,16.75509 -1.8728,22.27093 -7.3927,4.06195 -15.2646,7.42978 -23.2291,10.23914 -21.7618,7.67627 -44.3198,12.1369 -67.1284,15.30517 -17.561,2.43933 -35.1225,4.98065 -52.7559,6.76279 -15.7038,1.58716 -31.4925,2.6395 -47.2688,3.147 -39.765,1.27924 -79.5401,2.66821 -119.31906,2.96442 -33.63099,0.25049 -67.27674,-0.81052 -100.90845,-1.60629 -16.63135,-0.39356 -33.26984,-1.16748 -49.86127,-2.37241 -16.88403,-1.2262 -33.7948,-2.61972 -50.54907,-4.97131 -24.90418,-3.49546 -49.86377,-7.03119 -74.4491,-12.21338 -16.93774,-3.57022 -33.25689,-10.03961 -49.90124,-15.05127 -9.87769,-2.97418 -12.04297,-13.11038 -3.88971,-20.81195 5.95215,-5.62244 13.18188,-10.17703 20.45257,-14.0665 23.44312,-12.54092 49.02954,-19.36401 74.3703,-26.75723 6.52088,-1.9025 13.1167,-3.54807 20.19037,-4.91825 0.89575,11.49323 6.89569,18.84281 16.09723,24.26529 15.76062,9.28769 32.68183,15.9429 50.46521,19.48853 20.0882,4.00512 40.44812,6.97424 60.8241,9.11712 20.76452,2.18369 41.677,3.26627 62.55371,3.9726 14.59778,0.4939 29.25604,-0.18872 43.86584,-0.83258 15.90307,-0.70081 31.78017,-1.98303 47.67067,-2.9773 21.5552,-1.34872 42.7762,-4.8475 63.6947,-10.12576 17.1178,-4.31921 33.8824,-9.5249 48.8558,-19.40967 8.0796,-5.3338 14.2476,-11.44665 13.6571,-22.03387 -0.051,-0.91553 1.0241,-1.89386 1.576,-2.84302 z"
+     id="path8" />
+  <path
+     fill="#000000"
+     opacity="1"
+     stroke="none"
+     d="m 1159.4102,371.29181 c -0.3301,1.21817 -1.4052,2.1965 -1.3542,3.11203 0.5905,10.58722 -5.5775,16.70007 -13.6571,22.03387 -14.9734,9.88477 -31.738,15.09046 -48.8558,19.40967 -20.9185,5.27826 -42.1395,8.77704 -63.6947,10.12576 -15.8905,0.99427 -31.7676,2.27649 -47.67067,2.9773 -14.6098,0.64386 -29.26806,1.32648 -43.86584,0.83258 -20.87671,-0.70633 -41.78919,-1.78891 -62.55371,-3.9726 -20.37598,-2.14288 -40.7359,-5.112 -60.8241,-9.11712 -17.78338,-3.54563 -34.70459,-10.20084 -50.46521,-19.48853 -9.20154,-5.42248 -15.20148,-12.77206 -15.70459,-24.32397 5.31256,-16.82395 10.74469,-33.1958 16.58295,-49.95899 0.56903,-0.66574 0.53674,-0.91558 0.3092,-1.14087 0,0 0.007,-0.10058 0.0417,-0.13864 4.44128,14.99103 17.98163,18.59305 30.17304,23.24121 20.71691,7.89872 42.39459,12.13648 64.45574,14.02503 22.96515,1.96597 45.94788,4.06491 68.96747,4.95709 21.06964,0.81662 42.23566,0.8797 63.29321,-0.11816 34.44911,-1.63242 68.80621,-4.62036 102.29911,-13.76477 13.7229,-3.74668 26.7592,-8.8479 38.6563,-16.84739 4.0497,-2.72293 6.3067,-5.68411 5.7093,-11.01348 3.7533,9.88632 7.4177,20.22006 11.1411,30.53247 2.217,6.14016 4.5268,12.24679 7.0168,18.63751 z"
+     id="path13" />
+  <path
+     fill="#000000"
+     opacity="1"
+     stroke="none"
+     d="m 767.49426,321.87805 c 0.38971,0.12818 0.422,0.37802 0.0761,0.72339 -0.37011,-0.14789 -0.38855,-0.38028 -0.0761,-0.72339 z"
+     id="path17" />
+</svg>

agent_cli-0.95.0/macos/AgentCLI/Package.resolved

@@ -0,0 +1,14 @@
+{
+  "pins" : [
+    {
+      "identity" : "keyboardshortcuts",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/sindresorhus/KeyboardShortcuts",
+      "state" : {
+        "revision" : "70caa8dea43e2d273cd5ab78885d7eff01df550c",
+        "version" : "1.10.0"
+      }
+    }
+  ],
+  "version" : 2
+}

agent_cli-0.95.0/macos/AgentCLI/Package.swift

@@ -0,0 +1,25 @@
+// swift-tools-version: 5.9
+
+import PackageDescription
+
+let package = Package(
+    name: "AgentCLI",
+    platforms: [
+        .macOS(.v13),
+    ],
+    products: [
+        .executable(name: "AgentCLI", targets: ["AgentCLI"]),
+    ],
+    dependencies: [
+        .package(url: "https://github.com/sindresorhus/KeyboardShortcuts", exact: "1.10.0"),
+    ],
+    targets: [
+        .executableTarget(
+            name: "AgentCLI",
+            dependencies: [
+                .product(name: "KeyboardShortcuts", package: "KeyboardShortcuts"),
+            ],
+            path: "Sources/AgentCLI"
+        ),
+    ]
+)

agent_cli-0.95.0/macos/AgentCLI/README.md

@@ -0,0 +1,97 @@
+# Agent CLI macOS app
+
+This directory contains a native SwiftUI menu bar wrapper for `agent-cli`.
+The app does not reimplement any agent behavior. It bundles `uv`, installs a
+private `agent-cli[audio,llm]` tool into the user's Application Support
+directory on first use, and shells out to that private executable.
+
+Transcription is the default zero-config path. The first transcription action
+installs and starts the local Whisper launchd daemon with
+`agent-cli daemon install whisper -y`; the model is downloaded lazily by the
+server on first transcription request. No existing `agent-cli` config file is
+required.
+
+The packaged app registers native macOS global hotkeys itself:
+
+- `Fn+Space` toggles transcription
+- `Fn` records while held and inserts the transcript
+- `Cmd+Shift+A` autocorrects clipboard text
+- `Cmd+Shift+V` starts voice edit
+
+Choose **Keyboard Shortcuts...** from the menu bar app to change these
+shortcuts. The settings UI uses the `KeyboardShortcuts` Swift package for
+shortcut parsing, `UserDefaults` storage, and global key-up handlers.
+
+## Build
+
+From the repository root:
+
+```bash
+./macos/build-macos-app.sh
+```
+
+The app bundle is written to `dist/macos/AgentCLI.app`.
+
+## Install locally
+
+```bash
+./macos/build-macos-app.sh --install
+```
+
+This builds the app, copies it to `/Applications/AgentCLI.app`, and opens it.
+
+## Build a DMG
+
+```bash
+./macos/build-macos-app.sh --dmg
+```
+
+The DMG is written to `dist/macos/AgentCLI.dmg`.
+
+## End-to-end packaging check
+
+```bash
+./macos/test-macos-app-e2e.sh
+```
+
+The E2E test builds the app and DMG, verifies code signing and the image, then
+uses a fake bundled `uv` to prove the app bootstraps its private CLI, installs
+the Whisper daemon, and runs the default transcription command without network
+downloads.
+
+## Signing
+
+By default the script ad-hoc signs the local app bundle. For public
+distribution, pass a Developer ID identity and then notarize the resulting app
+or DMG:
+
+```bash
+CODESIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)" ./macos/build-macos-app.sh --dmg
+```
+
+To notarize during the build, set `NOTARIZE=1` and provide Apple notary
+credentials:
+
+```bash
+CODESIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)" \
+NOTARIZE=1 \
+APPLE_ID="you@example.com" \
+APPLE_APP_SPECIFIC_PASSWORD="xxxx-xxxx-xxxx-xxxx" \
+APPLE_TEAM_ID="TEAMID" \
+./macos/build-macos-app.sh --dmg
+```
+
+## Release CI
+
+Publishing a GitHub release runs `.github/workflows/release.yml`, which imports
+the Developer ID certificate with `apple-actions/import-codesign-certs`, builds,
+notarizes, staples, and uploads `dist/macos/AgentCLI.dmg` to the release. The
+workflow expects these repository secrets:
+
+- `MACOS_CODESIGN_CERTIFICATE_BASE64`: base64-encoded Developer ID Application
+  `.p12` certificate export
+- `MACOS_CODESIGN_CERTIFICATE_PASSWORD`: password for that `.p12`
+- `MACOS_KEYCHAIN_PASSWORD`: temporary CI keychain password
+- `APPLE_ID`: Apple ID email for notarization
+- `APPLE_APP_SPECIFIC_PASSWORD`: app-specific password for `notarytool`
+- `APPLE_TEAM_ID`: Apple Developer Team ID

agent_cli-0.95.0/macos/AgentCLI/Resources/Info.plist

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleDisplayName</key>
+	<string>Agent CLI</string>
+	<key>CFBundleExecutable</key>
+	<string>AgentCLI</string>
+	<key>CFBundleIdentifier</key>
+	<string>lt.nijho.agent-cli.menubar</string>
+	<key>CFBundleIconFile</key>
+	<string>AgentCLI</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>Agent CLI</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>0.1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+	<key>LSMinimumSystemVersion</key>
+	<string>13.0</string>
+	<key>LSUIElement</key>
+	<true/>
+	<key>NSMicrophoneUsageDescription</key>
+	<string>Agent CLI uses microphone access when you start transcription or voice editing from the menu bar.</string>
+</dict>
+</plist>