Single Go binary · macOS · Linux · Windows

An AI coding agent that asks first.

GopherMind points at a model you run — local llama.cpp, Ollama, LM Studio, vLLM, or any hosted OpenAI-compatible endpoint. It reads, searches, edits and runs commands in your repo, and every action that changes something stops for your approval.

gophermind — approval mode: ask

It stopped. That is the whole design. Nothing mutates without a yes.

Why this one

Your model, your machine

Anything that speaks the OpenAI /v1 API. Models are discovered from the endpoint, and named provider profiles switch backends without editing config.

No account. No telemetry to us. Point it at localhost and unplug the network.

Safe at every layer

File paths are contained to your repo and checked through symlinks. Shell commands pass a deny-list. Mutating tools hit the approval gate unless you opt into auto.

Plus a read-only mode, per-role tool restrictions that fail closed, and --dry-run to preview a whole run.

Small enough to read

Pure Go, no CGO, one static binary. Adding a tool is still one struct and one function — the codebase stays legible as it grows.

Signed and notarized on macOS. Every release ships an SBOM and checksums.txt.

Batteries, all switched off

A local semantic index and RAG, a read-only SQL/Parquet/CSV toolkit, multi-agent strategies, an MCP client and server, WASM plugins, Prometheus metrics.

Every integration is inert until you configure it, so the default install stays small and quiet.

Install

macOS

brew install jbrahy/tap/gophermind

A signed and notarized universal binary — no Gatekeeper warning.

Any platform

npm install -g gophermind

Downloads the prebuilt binary for your platform. x64 and arm64.

Linux packages

.deb · .rpm · .apk · .tar.gz

Grab one from the latest release. Windows users, a .zip.

From source

git clone https://github.com/jbrahy/gophermind.com
cd gophermind.com
make build

Go 1.25 or newer.

First run

Interactive

gophermind

A wizard asks for your endpoint, an optional key, a model from a live list, and your approval mode — then saves it.

One shot

gophermind run "add a --json flag"

Non-interactive. Same gate, same tools.

Read only

gophermind ask "how does retry work?"

Answers questions about the repo. Never edits.