Blog
Notes from building Minnie
- 31 October 2026
Claude Code "Stream idle timeout": what it means, fixed
API Error: Stream idle timeout in Claude Code means the response went quiet. Why it happens, the Mac sleep case, and when raising the timeout helps.
- 29 October 2026
Claude Code on Mac: Terminal vs iTerm2 vs Ghostty
Which Mac terminal works best with Claude Code: notifications, Shift+Enter, Option as Meta, copy and paste, and the one setting each terminal needs.
- 27 October 2026
How to add an MCP server to Claude Code
The claude mcp add command for remote and local servers, which scope to pick, signing in with /mcp, and how to tell why a server won't connect.
- 25 October 2026
"Apple could not verify claude" on Mac: is it safe?
macOS blocked Claude Code with a malware warning. Why it happens, a one-command check that it's really Anthropic's, and the safe fixes in order.
- 23 October 2026
Uninstall Claude Code from a Mac completely
Removing the claude command is one line. Removing Claude Code completely means your settings, its caches, and the login it keeps in the macOS Keychain.
- 21 October 2026
Install Codex CLI on a Mac: installers, PATH and sandbox
Three ways to install OpenAI's Codex CLI on macOS, which file the installer quietly edits, how to untangle two copies, and what the Mac sandbox lets it do.
- 19 October 2026
Gemini CLI stopped working? Moving to Antigravity on Mac
Since June 2026, Gemini CLI no longer serves free and Google AI Pro accounts. Who is affected, the Homebrew trap, and how to move to Antigravity CLI.
- 17 October 2026
Keep your Mac awake while Claude Code works
A long Claude Code task, and your Mac fell asleep halfway through? How to stop that with caffeinate, and what closing the lid actually does.
- 15 October 2026
Claude Code worktrees: run parallel sessions safely
How claude --worktree works, the setup step everyone skips, what happens to your branch on exit, and how to keep track of three agents at once.
- 14 October 2026
Bongo Cat on Mac: free open-source app vs Steam
Two Bongo Cats run on a Mac: the free open-source app, no Steam needed, and the Steam game. Which to pick, and the permission macOS asks for.
- 14 October 2026
zsh: command not found: claude on Mac, fixed
Claude Code installed, but zsh says command not found: claude. The five causes in the order to check them, with the exact fix for zsh and bash.
- 13 October 2026
Claude Code /buddy is gone. These pets replaced it
Anthropic's /buddy terminal pet lasted a week in April 2026. What happened, whether you can get it back, and the desktop pets that react to Claude Code.
- 13 October 2026
Claude Code notifications on Mac: why they don't fire
Claude Code only sends desktop alerts in three terminals, and its hook alerts can lag a minute. How to get told the moment it finishes or needs you.
- 13 October 2026
Desktop Goose on Mac in 2026: it runs, for now
The Mac build of Desktop Goose dates from 2020. How to run it on Apple Silicon today, how to get rid of the goose, and what changes after macOS 27.
- 13 October 2026
Shimeji on Mac in 2026: Shijima and what still runs
The Mac app most people used for Shimeji was discontinued in 2026. What still runs on Apple Silicon, how to import a shimeji, and what to skip.
- 7 October 2026
Claude Code has no GUI. Here is what people use
Claude Code is a terminal tool, so every interface around it is third-party. An honest look at the desktop apps, what each is actually for, and how to pick.
- 7 October 2026
Claude Code vs Gemini CLI vs Codex on a Mac
Three terminal coding agents, three different temperaments. What each is good at, how they differ day to day, and why you do not have to pick just one.
- 7 October 2026
Desktop pets for Mac: Shimeji, Bongo Cat and co
A guide to desktop pets on macOS — the classics, the modern open-source ones, and the new kind that are wired to something real on your machine.
- 7 October 2026
Install Claude Code on a Mac, start to finish
The short path to a working Claude Code on macOS: which installer to use, how to log in, what to do in your first repo, and what usually goes wrong.
- 2 October 2026
Claude Code, Gemini CLI or Codex: one desktop pet for all
Minnie doesn't care which coding agent you use. How she works with Claude Code, Gemini CLI, Codex, Antigravity and custom CLIs, and exactly where they differ.
- 2 October 2026
Claude Code permission prompts, without the babysitting
Claude Code asks before it runs tools. How to build an allowlist, or let /fewer-permission-prompts draft one, and stop watching the terminal window.
- 2 October 2026
A desktop pet for your Mac that actually does work
Desktop pets used to be pure decoration. Minnie sits on your Mac like one, but she runs your AI coding agent, asks before she acts, and costs nothing extra.
- 2 October 2026
Why Minnie is free: bring your own AI agent
Most AI tools charge for the model on top of the app. Minnie drives the coding agent you already pay for, so the app is free and there's no second AI bill.
- 2 October 2026
What a local-first AI coding assistant keeps on your Mac
"Private" means different things for different AI tools. What Minnie keeps on your Mac, what your agent's provider sees, and what to ask any tool.
- 2 October 2026
MCP servers, explained for people who just want it to work
What Model Context Protocol is, which servers to start with, where Claude Code, Codex and Gemini CLI keep their MCP config, and the security part.
- 2 October 2026
"Apple could not verify" this app: what it means
Why macOS warns about unsigned apps, what the warning does and doesn't tell you, how to check an app yourself, and how to open one you trust.
- 2 October 2026
Voice coding: speaking prompts your agent understands
Talking to a coding agent is different from typing to it. Practical habits for spoken prompts that are short, specific and hard to misunderstand.
- 10 September 2026
Talk to Claude Code with your voice on a Mac
Claude Code is a terminal tool: no voice, no window. The three ways people add one, what each is good at, and why the permission prompt was the hard part.