White-screen renderer-crash fix, working auto-update (first live updater channel), and opt-in error/crash monitoring.

Updating preserves your library — indexed data lives in ~/Library/Application Support/Minion 2 and is untouched by the update.

Builds before 3.2.1 do not self-update, so this one is a manual install; 3.2.1+ auto-updates.

Minion Two — v3.1.0

Retrieval quality, roughly doubled. Removed an identity/graph reranking step that was silently scrambling search results. On our end-to-end benchmark (BEIR/scifact through the real ask_minion path) this lifted nDCG@10 0.345 → 0.657 (+90%) and MRR 0.195 → 0.599, with no model change — the right answer now lands near the top instead of buried mid-list.

New: graph_traverse tool. Agents can walk your knowledge graph multi-hop from an entity by name ("how is X connected to Y?") — a dedicated graph surface that never interferes with search ranking.

New: live dashboard. The home screen shows real-time Sources / Chunks / Knowledge-graph (branches · edges · communities) / Embedder stats. Graph building is automatic as you add files.

Better chunking. Short docs (abstracts, notes, emails, chat turns) are no longer fragmented — chunk size now matches the embedder's context budget.

Install (macOS)

This is an unsigned ad-hoc build, so macOS quarantines it on download. To run it:

1. Download the build for your Mac:
   • Apple Silicon (M1/M2/M3/M4) → Minion-3.1.0-macOS-AppleSilicon.app.tar.gz
   • Intel → Minion-3.1.0-macOS-Intel.app.tar.gz
2. Double-click the .tar.gz to extract Minion 2.app, then drag it into /Applications.
3. Remove the quarantine flag — open Terminal and run:

   xattr -cr "/Applications/Minion 2.app"
   

4. Open it (double-click). Without step 3, macOS will say the app is "damaged" — that's just Gatekeeper on an unsigned app, not a real problem.

Minion Two — patch release.

Fixes

• Scrolling: the main window no longer clips content — the setup / connector checklist below the fold is now reachable.
• Housekeeping: removed an internal developer note that should not have appeared in a shipped build.

Everything from 3.0.0 otherwise applies: 768-d bge-base-en-v1.5 embedder, corpus-agnostic knowledge-graph build on ingest, and the drop-zone UI with a live, plain-language ingest feed.

Downloads

• Apple Silicon: Minion-3.0.1-macOS-AppleSilicon.app.tar.gz
• Intel: Minion-3.0.1-macOS-Intel.app.tar.gz

The app is unsigned — on first launch, right-click → Open (or System Settings → Privacy & Security → "Open Anyway"). First launch downloads the embedding model (~130 MB).

🤖 Generated with Claude Code

Hotfix for a runtime issue introduced in 3.1.0.

Fix: the inbox watcher could recursively ingest macOS app bundles and dependency/cache folders (e.g. a .app, node_modules, or a bundled runtime's files) when such a folder was added to the inbox. On large/nested folders this pinned the CPU and could corrupt and reset the local index. 3.1.1 skips those folders entirely, caps oversized files, and pauses auto-reindex after a recovery so a single hiccup can't loop.

Upgrade: download the build for your Mac, unzip, and replace the existing Minion 2 app in /Applications.

• Apple Silicon (M-series): Minion-3.1.1-macOS-AppleSilicon.app.tar.gz
• Intel: Minion-3.1.1-macOS-Intel.app.tar.gz

Your data is untouched by updating — memories and inbox live in your user data folder, not in the app.

Summary

• Rebuilt Minion Desktop as a chat-first local agent using React, Tailwind, and vendored ElevenLabs UI registry components.
• Added Context Core: ambient coverage, witness fusion, evidence-backed candidates, and unified MCP context bundles.
• Promoted Contacts ingestion into the graph path and fixed macOS Contacts snapshot/import reliability.
• Removed the retired SvelteKit desktop shell and old activity UI surface.

Artifact

• Intel macOS manual install tarball: Minion-2.0.0-macOS-Intel.app.tar.gz

Verification

• Python: 193 passed
• Desktop type-check: passed
• Desktop unit: 2 passed
• Rust: 12 passed
• Playwright E2E: 12 passed

Notes

• This local build is not updater-signed because TAURI_SIGNING_PRIVATE_KEY was not available in the local environment.

Pick one download for her Mac

• Apple Silicon (M1 / M2 / M3 / M4 MacBooks and desktops):
  Minion_1.0.2_aarch64.app.tar.gz

• Intel Mac:
  Minion_1.0.2_x64.app.tar.gz

(Not sure? On the Mac: Apple menu → About This Mac → look for Chip vs Processor. Chip = Silicon → first link.)

Install (simple)

1. Click the link above — Safari downloads the file.
2. Open the downloaded .tar.gz (double‐click) — it unpacks Minion.app.
3. Drag Minion into Applications.
4. Open Minion from Applications (the first launch may mention download-from-internet — choose Open).

What changed

• Fixes searches failing when the embedding model vanished from a temporary folder.
• The built‐in updater checks for new versions sooner while the app is running.

Desktop

• Silent signed auto-updates when Install updates automatically is on (Settings → Support); optional confirm when off.
• Throttle skips failed update checks.

MCP (Claude / clients)

• Shorter ask_minion tool description; compact voice-bootstrap instructions.
• Tool results: single JSON in content (no duplicate structuredContent); profile_brief only in that JSON on first call.

Repo

• eval/run_eval.py: tool_result_payload(); golden tests updated.
• chatgpt_mcp_memory/tests/test_mcp_tool_result_shape.py; GitHub Actions (CI + targeted MCP pytest).
• See desktop/README.md for building signed .app.tar.gz and publishing latest.json.

Minion 1.0.0

Downloads — read the file name

There are two zip files. Pick the one that matches the Mac:

How to check: Apple menu → About This Mac.

• If you see Chip: "Apple M2" (or any Apple M...) → use Apple-Silicon zip.
• If you see Processor: "Intel Core i7" (or any Intel CPU) → use Intel zip.

Wrong zip → the app may not open. Delete Minion.app, download the other zip, unzip, move Minion.app to Applications again.

After install

Unzip, drag Minion.app to Applications, then open. First launch prepares the local Python environment.

Highlights

• Desktop (Tauri) + Python sidecar at 1.0.0
• GET /status includes version; MCP initialize → serverInfo.version
• Optional Ollama CPU cap: MINION_OLLAMA_MAX_CPU_PCT (default 30), MINION_OLLAMA_MAX_INFLIGHT

Docs

• README — install & which zip
• chatgpt_mcp_memory/README

Ollama: Install Ollama for Mac for the same kind of Mac (Apple Silicon build vs Intel build) if you use local vision/LLM.

macOS build

Minion.app is inside Minion-0.3.19-macos.app.zip. Unzip, then drag Minion.app to Applications (or run it from the unzip folder).

Changes

• SQLite: Ordered self-recovery (remove stale -wal/-shm, force DELETE journal, synchronous=FULL, then move a corrupt memory.db aside) with PRAGMA quick_check after each successful open. Skips DB rotation when errors look like disk-full.
• Desktop: Retry sidecar health after nuke/factory reset; database status on /status; db_error WebSocket + banner when the DB cannot open.
• Bundle: Post-build macOS sanitize (xattr / immutable flags / permissions).

Apple Silicon + Intel universal binary is not guaranteed by this artifact; this build was produced on the machine that ran tauri build.

Minion 0.3.18 (macOS)

• Fix: Live ingest activity no longer shows a false failed line when the file was actually indexed. The inbox watcher now resolves and dedupes filesystem paths so WebSocket progress and completion use the same path key as the sidecar.

Download: Minion-0.3.18-macos.zip — unzip and drag Minion.app to Applications. (Unsigned build; you may need to allow it in Gatekeeper.)

Python sidecar changes ship inside the app bundle.