agent-cli 0.95.10__tar.gz → 0.95.12__tar.gz

{agent_cli-0.95.10 → agent_cli-0.95.12}/Casks/agent-cli.rb

@@ -1,6 +1,6 @@
 cask "agent-cli" do
-  version "0.95.9"
-  sha256 "b2d7dd26b67fceb32db31d5506c0890f9c879f56d049e6fd051fac151b68a300"
+  version "0.95.11"
+  sha256 "01325c0381270bae9a76528dc54585337274087d4890c0db4078406289ef6323"
 
   url "https://github.com/basnijholt/agent-cli/releases/download/v#{version}/AgentCLI.dmg"
   name "Agent CLI"

{agent_cli-0.95.10 → agent_cli-0.95.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.95.10
+Version: 0.95.12
 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>
@@ -157,6 +157,17 @@ Since then I have expanded the tool with many more features, all focused on loca
 
 ## Quick Start
 
+### Prefer the macOS menu bar app?
+
+Install the native AgentCLI app with Homebrew:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+The app provides global shortcuts, a menu bar UI, automatic local Whisper setup on first transcription, and a private bundled `agent-cli` runtime. See the [macOS app guide](docs/installation/macos-app.md) for setup, updates, and uninstall instructions.
+
 ### Just want the CLI tool?
 
 If you already have AI services running (or plan to use OpenAI), simply install:
@@ -247,6 +258,7 @@ The setup scripts automatically install:
     - [Step 2: Run the Setup Script](#step-2-run-the-setup-script)
     - [Step 3: Start All Services](#step-3-start-all-services)
     - [Step 4: Test Your Installation](#step-4-test-your-installation)
+- [macOS Menu Bar App](#macos-menu-bar-app)
 - [System Integration](#system-integration)
   - [macOS Hotkeys](#macos-hotkeys)
   - [Linux Hotkeys](#linux-hotkeys)
@@ -352,6 +364,28 @@ source .venv/bin/activate  # On Windows: .venv\Scripts\activate
 
 </details>
 
+## macOS Menu Bar App
+
+AgentCLI is also available as a native macOS menu bar app for voice workflows that should work from any app without keeping a terminal open.
+
+Install it with Homebrew:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+The app is a SwiftUI wrapper around the same `agent-cli` commands. It bundles `uv`, installs a private `agent-cli[audio,llm]` runtime in your Application Support folder on first use, and starts the local Whisper daemon automatically the first time you transcribe.
+
+Default shortcuts:
+
+- **`Fn+Space`** - Toggle transcription
+- **`Fn`** - Record while held and insert the transcript
+- **`Cmd+Shift+A`** - Autocorrect clipboard text
+- **`Cmd+Shift+V`** - Start voice edit
+
+You can change shortcuts, enable **Start at Login**, or switch to a user-installed `agent-cli` runtime from the app's **Settings...** screen. See the [macOS app guide](docs/installation/macos-app.md) for details.
+
 ## System Integration
 
 Want system-wide hotkeys? You'll need the repository for the setup scripts:

{agent_cli-0.95.10 → agent_cli-0.95.12}/README.md

@@ -53,6 +53,17 @@ Since then I have expanded the tool with many more features, all focused on loca
 
 ## Quick Start
 
+### Prefer the macOS menu bar app?
+
+Install the native AgentCLI app with Homebrew:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+The app provides global shortcuts, a menu bar UI, automatic local Whisper setup on first transcription, and a private bundled `agent-cli` runtime. See the [macOS app guide](docs/installation/macos-app.md) for setup, updates, and uninstall instructions.
+
 ### Just want the CLI tool?
 
 If you already have AI services running (or plan to use OpenAI), simply install:
@@ -143,6 +154,7 @@ The setup scripts automatically install:
     - [Step 2: Run the Setup Script](#step-2-run-the-setup-script)
     - [Step 3: Start All Services](#step-3-start-all-services)
     - [Step 4: Test Your Installation](#step-4-test-your-installation)
+- [macOS Menu Bar App](#macos-menu-bar-app)
 - [System Integration](#system-integration)
   - [macOS Hotkeys](#macos-hotkeys)
   - [Linux Hotkeys](#linux-hotkeys)
@@ -248,6 +260,28 @@ source .venv/bin/activate  # On Windows: .venv\Scripts\activate
 
 </details>
 
+## macOS Menu Bar App
+
+AgentCLI is also available as a native macOS menu bar app for voice workflows that should work from any app without keeping a terminal open.
+
+Install it with Homebrew:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+The app is a SwiftUI wrapper around the same `agent-cli` commands. It bundles `uv`, installs a private `agent-cli[audio,llm]` runtime in your Application Support folder on first use, and starts the local Whisper daemon automatically the first time you transcribe.
+
+Default shortcuts:
+
+- **`Fn+Space`** - Toggle transcription
+- **`Fn`** - Record while held and insert the transcript
+- **`Cmd+Shift+A`** - Autocorrect clipboard text
+- **`Cmd+Shift+V`** - Start voice edit
+
+You can change shortcuts, enable **Start at Login**, or switch to a user-installed `agent-cli` runtime from the app's **Settings...** screen. See the [macOS app guide](docs/installation/macos-app.md) for details.
+
 ## System Integration
 
 Want system-wide hotkeys? You'll need the repository for the setup scripts:

{agent_cli-0.95.10 → agent_cli-0.95.12}/docs/getting-started.md

@@ -17,7 +17,18 @@ Before you begin, ensure you have:
 
 ## Installation
 
-### Option 1: CLI Tool Only
+### Option 1: macOS Menu Bar App
+
+For the native Mac app with global shortcuts and automatic local Whisper setup:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+See: [macOS Menu Bar App](installation/macos-app.md)
+
+### Option 2: CLI Tool Only
 
 If you already have AI services set up or plan to use cloud services (OpenAI/Gemini):
 
@@ -33,7 +44,7 @@ pip install agent-cli
 > The `-p 3.13` flag is required because some dependencies don't support Python 3.14 yet.
 > See [uv issue #8206](https://github.com/astral-sh/uv/issues/8206) for details.
 
-### Option 2: Full Local Setup
+### Option 3: Full Local Setup
 
 For a complete local setup with all AI services:
 
@@ -138,6 +149,7 @@ For detailed installation instructions, see the platform-specific guides:
 
 | Platform | Guide | Notes |
 |----------|-------|-------|
+| :fontawesome-brands-apple: **macOS app** | [macOS App](installation/macos-app.md) | Native menu bar app |
 | :fontawesome-brands-apple: **macOS** | [macOS Setup](installation/macos.md) | Full Metal GPU acceleration |
 | :fontawesome-brands-linux: **Linux** | [Linux Setup](installation/linux.md) | NVIDIA GPU support |
 | :simple-nixos: **NixOS** | [NixOS Setup](installation/nixos.md) | Declarative configuration |

{agent_cli-0.95.10 → agent_cli-0.95.12}/docs/index.md

@@ -69,6 +69,17 @@ Since then I have expanded the tool with many more features, all focused on loca
 
 ## Quick Start
 
+### Prefer the macOS app?
+
+Install the native menu bar app with Homebrew:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+The app provides global shortcuts, a menu bar UI, automatic local Whisper setup, and a private bundled `agent-cli` runtime. See the [macOS app guide](installation/macos-app.md).
+
 ### Just want the CLI tool?
 
 If you already have AI services running (or plan to use OpenAI):
@@ -129,6 +140,7 @@ The setup automatically installs:
 ## Documentation
 
 - [Getting Started](getting-started.md) - Installation and first steps
+- [macOS App](installation/macos-app.md) - Native menu bar app and Homebrew cask
 - [Configuration](configuration.md) - All configuration options
 - [Commands](commands/index.md) - CLI reference
 - [System Integration](system-integration.md) - Hotkeys and system setup

{agent_cli-0.95.10 → agent_cli-0.95.12}/docs/installation/index.md

@@ -10,7 +10,8 @@ Choose the best installation method for your platform and performance needs.
 
 | Platform         | Recommended Method             | GPU Support   | Performance |
 | ---------------- | ------------------------------ | ------------- | ----------- |
-| **macOS**        | [Native Setup](macos.md)       | ✅ Metal GPU  | Best        |
+| **macOS app**    | [Menu Bar App](macos-app.md)   | ✅ Metal GPU  | Best        |
+| **macOS CLI**    | [Native Setup](macos.md)       | ✅ Metal GPU  | Best        |
 | **Linux**        | [Native Setup](linux.md)       | ✅ NVIDIA GPU | Best        |
 | **NixOS**        | [System Integration](nixos.md) | ✅ NVIDIA GPU | Best        |
 | **Any Platform** | [Docker Setup](docker.md)      | ⚠️ Limited\*  | Good        |
@@ -20,7 +21,18 @@ Choose the best installation method for your platform and performance needs.
 
 ## Installation Methods
 
-### 🍎 macOS Native (Recommended)
+### 🍎 macOS Menu Bar App
+
+**Best desktop workflow for voice transcription and clipboard actions**
+
+- Native menu bar app with global shortcuts
+- Private bundled `agent-cli` runtime
+- Automatic local Whisper setup on first transcription
+- Installable with Homebrew Cask
+
+👉 [Follow macOS App Guide](macos-app.md)
+
+### 🍎 macOS Native CLI
 
 **Best performance with Metal GPU acceleration**
 

agent_cli-0.95.12/docs/installation/macos-app.md

@@ -0,0 +1,94 @@
+---
+icon: lucide/panel-top
+---
+
+# macOS Menu Bar App
+
+Agent CLI also ships as a native macOS menu bar app for voice workflows that should be available from any app without keeping a terminal open.
+
+The app is a SwiftUI wrapper around the same `agent-cli` commands. It bundles `uv`, installs a private `agent-cli[audio,llm]` runtime in your Application Support folder on first use, and starts the local Whisper daemon automatically the first time you transcribe.
+
+## Requirements
+
+- Apple Silicon Mac
+- macOS 13 Ventura or later
+- Microphone permission for transcription
+- Accessibility permission if you want AgentCLI to insert text into other apps
+
+## Install with Homebrew
+
+Install the signed app release with the Homebrew cask:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+Then open **AgentCLI** from `/Applications` or Spotlight.
+
+If you already cloned the repository and want to install the cask from the local checkout:
+
+```bash
+brew install --cask ./Casks/agent-cli.rb
+```
+
+## First Launch
+
+1. Open **AgentCLI**.
+2. Approve macOS microphone permission when prompted.
+3. Use the menu bar icon to start transcription, autocorrect clipboard text, or open Settings.
+4. Grant Accessibility permission in System Settings if auto-insert or clipboard automation is blocked.
+
+The first transcription can take longer because AgentCLI installs the private CLI runtime, ensures the Whisper launchd daemon is available, and downloads the speech model lazily.
+
+## Default Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Fn+Space` | Toggle transcription |
+| `Fn` | Record while held and insert the transcript |
+| `Cmd+Shift+A` | Autocorrect clipboard text |
+| `Cmd+Shift+V` | Start voice edit |
+
+Open **Settings...** from the menu bar app to change shortcuts, enable **Start at Login**, or switch runtime modes.
+
+## Runtime Modes
+
+By default, the app manages its own private `agent-cli` install so the menu bar workflow is zero-config and does not depend on your shell PATH.
+
+If you already manage `agent-cli` yourself, enable **Use User-Installed agent-cli** in Settings. AgentCLI will then run the `agent-cli` executable found on PATH and use your normal configuration.
+
+## Updates
+
+The app uses Sparkle for direct updates. Choose **Check for Updates...** from the menu bar app or Settings to check for a newer signed release.
+
+If you installed with Homebrew, you can also update through Homebrew:
+
+```bash
+brew update
+brew upgrade --cask agent-cli
+```
+
+## Uninstall
+
+```bash
+brew uninstall --cask agent-cli
+```
+
+To remove app data, launch agents, logs, and preferences as well:
+
+```bash
+brew uninstall --zap --cask agent-cli
+```
+
+## Build from Source
+
+From the repository root:
+
+```bash
+./macos/build-macos-app.sh --install
+```
+
+This builds the app, copies it to `/Applications/AgentCLI.app`, and opens it.
+
+For packaging and release details, see the [macOS app README](https://github.com/basnijholt/agent-cli/blob/main/macos/AgentCLI/README.md).

{agent_cli-0.95.10 → agent_cli-0.95.12}/docs/installation/macos.md

@@ -9,6 +9,9 @@ Native macOS setup with full Metal GPU acceleration for optimal performance.
 > [!TIP]
 > **🍎 Recommended for macOS** — ~10x better performance than Docker via Metal GPU acceleration.
 
+> [!NOTE]
+> Prefer a menu bar app with global shortcuts and no terminal session? See the [macOS Menu Bar App](macos-app.md), which can be installed with Homebrew.
+
 ## Prerequisites
 
 - macOS 12 Monterey or later

{agent_cli-0.95.10 → agent_cli-0.95.12}/docs/system-integration.md

@@ -12,6 +12,17 @@ Agent CLI is designed to work with system-wide hotkeys, allowing you to trigger
 
 ## macOS Setup
 
+### Native Menu Bar App
+
+For the easiest macOS hotkey workflow, install the native AgentCLI menu bar app:
+
+```bash
+brew tap basnijholt/agent-cli https://github.com/basnijholt/agent-cli
+brew install --cask agent-cli
+```
+
+The app registers global shortcuts itself and can manage a private `agent-cli` runtime. See the [macOS app guide](installation/macos-app.md).
+
 ### Automated Setup (Recommended)
 
 ```bash

agent_cli-0.95.12/macos/AgentCLI/Sources/AgentCLI/VoiceStatusMenuItem.swift

@@ -0,0 +1,10 @@
+import SwiftUI
+
+struct VoiceStatusMenuItem: View {
+    let runner: AgentCommandRunner
+
+    var body: some View {
+        Text("Voice: \(runner.menuStatusMessage)")
+            .lineLimit(1)
+    }
+}

agent_cli-0.95.12/macos/appcast.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss xmlns:sparkle="http://www.andymatuschak.org/xml-namespaces/sparkle" version="2.0">
+    <channel>
+        <title>Agent CLI Updates</title>
+        <link>https://github.com/basnijholt/agent-cli</link>
+        <description>Signed Agent CLI macOS app updates.</description>
+        <item>
+            <title>0.95.11</title>
+            <pubDate>Fri, 29 May 2026 03:31:10 +0000</pubDate>
+            <link>https://github.com/basnijholt/agent-cli</link>
+            <sparkle:version>169</sparkle:version>
+            <sparkle:shortVersionString>0.95.11</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
+            <sparkle:hardwareRequirements>arm64</sparkle:hardwareRequirements>
+            <description sparkle:format="markdown"><![CDATA[## What’s Changed
+
+* Fix macOS bootstrap menu refresh (#535) @basnijholt
+
+]]></description>
+            <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.95.11/AgentCLI.zip" length="22741421" type="application/octet-stream" sparkle:edSignature="fiMYQqjgxOE/xrXIaa47hP4YHwVvGrq1dy81hMmRCaFGWoU4T6ECg1pmLIt4JY1+JzmCJMC0enXkVTAipBVaCw=="/>
+        </item>
+        <item>
+            <title>0.95.10</title>
+            <pubDate>Fri, 29 May 2026 03:03:43 +0000</pubDate>
+            <link>https://github.com/basnijholt/agent-cli</link>
+            <sparkle:version>168</sparkle:version>
+            <sparkle:shortVersionString>0.95.10</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
+            <sparkle:hardwareRequirements>arm64</sparkle:hardwareRequirements>
+            <description sparkle:format="markdown"><![CDATA[## What’s Changed
+
+* Add Sparkle updater to macOS app (#534) @basnijholt
+* Repair stale Whisper daemon bootstrap (#533) @basnijholt
+* Fix macOS menu refresh during voice warmup (#532) @basnijholt
+* Fix Windows Swift source decoding (#531) @basnijholt
+
+]]></description>
+            <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.95.10/AgentCLI.zip" length="22741696" type="application/octet-stream" sparkle:edSignature="ojRVLbvdApEG2RyQMg9KDcZrYvraLyhso3tA4hJ4fldrPYmDPiX927Tevv18s50S2aCvdtjZ3+jdbiXMk+WBCw=="/>
+        </item>
+    </channel>
+</rss>

{agent_cli-0.95.10 → agent_cli-0.95.12}/tests/test_macos_app.py

@@ -570,15 +570,29 @@ def test_macos_app_animates_all_preparing_statuses_with_fixed_width_timer() -> N
     assert "elapsedSeconds: bootstrapElapsedSeconds" in source
 
 
+def test_macos_app_shows_voice_status_as_supported_menu_text() -> None:
+    """The status row should be visible in MenuBarExtra's SwiftUI menu content."""
+    source = swift_source()
+    voice_status = read_swift_source_file(SWIFT_SOURCE_DIR / "VoiceStatusMenuItem.swift")
+
+    assert "VoiceStatusMenuItem(runner: runner)" in source
+    assert "struct VoiceStatusMenuItem: View" in voice_status
+    assert 'Text("Voice: \\(runner.menuStatusMessage)")' in voice_status
+    assert "NSViewRepresentable" not in voice_status
+    assert "NSTextField" not in voice_status
+
+
 def test_macos_app_updates_bootstrap_status_without_rebuilding_menu_tree() -> None:
-    """Bootstrap animation should keep updating without refreshing the whole menu."""
+    """Bootstrap animation should not refresh the whole menu every second."""
     source = swift_source()
+    voice_status = read_swift_source_file(SWIFT_SOURCE_DIR / "VoiceStatusMenuItem.swift")
 
     assert "VoiceStatusMenuItem(runner: runner)" in source
-    assert 'Text("Voice: \\(runner.menuStatusMessage)")' not in source
-    assert "struct VoiceStatusMenuItem: View" in source
-    assert 'Text("Voice: \\(statusMessage)")' in source
-    assert ".onReceive(statusRefreshTimer)" in source
+    assert 'Text("Voice: \\(runner.menuStatusMessage)")' in voice_status
+    assert "Timer.publish" not in voice_status
+    assert "Timer(timeInterval:" not in voice_status
+    assert "@State" not in voice_status
+    assert ".onReceive" not in voice_status
     assert "@Published private var bootstrapAnimationTick" not in source
     assert "@Published private var bootstrapElapsedSeconds" not in source
     assert "private var bootstrapAnimationTick = 0" in source

{agent_cli-0.95.10 → agent_cli-0.95.12}/zensical.toml

@@ -18,6 +18,7 @@ nav = [
   { "Installation" = [
     { "Overview" = "installation/index.md" },
     { "macOS" = "installation/macos.md" },
+    { "macOS App" = "installation/macos-app.md" },
     { "Linux" = "installation/linux.md" },
     { "NixOS" = "installation/nixos.md" },
     { "Windows" = "installation/windows.md" },

agent_cli-0.95.10/macos/AgentCLI/Sources/AgentCLI/VoiceStatusMenuItem.swift

@@ -1,27 +0,0 @@
-import Foundation
-import SwiftUI
-
-struct VoiceStatusMenuItem: View {
-    let runner: AgentCommandRunner
-
-    @State private var statusMessage: String
-    private let statusRefreshTimer = Timer.publish(every: 0.8, on: .main, in: .common).autoconnect()
-
-    init(runner: AgentCommandRunner) {
-        self.runner = runner
-        _statusMessage = State(initialValue: runner.menuStatusMessage)
-    }
-
-    var body: some View {
-        Text("Voice: \(statusMessage)")
-            .lineLimit(1)
-            .onAppear(perform: refreshStatusMessage)
-            .onReceive(statusRefreshTimer) { _ in
-                refreshStatusMessage()
-            }
-    }
-
-    private func refreshStatusMessage() {
-        statusMessage = runner.menuStatusMessage
-    }
-}

agent_cli-0.95.10/macos/appcast.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<rss version="2.0" xmlns:sparkle="http://www.andymatuschak.org/xml-namespaces/sparkle">
-  <channel>
-    <title>Agent CLI Updates</title>
-    <link>https://github.com/basnijholt/agent-cli</link>
-    <description>Signed Agent CLI macOS app updates.</description>
-  </channel>
-</rss>