mango

README

🥭 mango

Generate conventional commit messages from your staged changes.

git add .
mango commit
# feat: add user authentication and password reset
# Commit with this message? [Y/n]  → commits for you

Install

go install github.com/natrimmer/mango@latest

Other install options (prebuilt binary, from source)

Prebuilt binary — grab your platform from Releases:

# macOS (Apple Silicon); swap for _darwin_amd64 / _linux_amd64 / _linux_arm64 / _windows_amd64.exe
curl -L https://github.com/natrimmer/mango/releases/latest/download/mango_darwin_arm64 -o mango
chmod +x mango && sudo mv mango /usr/local/bin/

From source:

git clone https://github.com/natrimmer/mango.git && cd mango && go build

Use

mango config set --api-key "sk-ant-..."   # one-time setup
git add .
mango commit                              # shows the message, then commits on confirm

On a terminal, mango commit prompts and runs git commit for you (with --count, pick an option by number). When output is piped or in CI, it instead prints a ready-to-run git commit command and commits nothing.

mango commit flags:

Flag	What it does
--type, -t <t>	Force a commit type (feat, fix, docs, …)
--context, -c "<text>"	Extra context to guide the message (e.g. "resolves #123")
--count, -n <n>	Offer N options to pick from instead of one
--dry-run	Show the prompt without calling the API
--verbose, -v	Show the prompt (as --dry-run does) plus the raw API response

Other commands: mango config show (show config), mango config models (list models), mango --version.

Models

Set with mango config set --model <name>:

• claude-opus-4-8 — most capable, slower, pricier
• claude-sonnet-4-6 — default, balanced
• claude-haiku-4-5 — fastest, cheapest

Commit message format & conventional types

Messages follow <type>: <description> — lowercase, imperative mood, no trailing period, ≤50 chars.

feat new feature · fix bug fix · docs documentation · style formatting · refactor · perf · test · chore · ci · build · revert

Configuration & storage

Config lives at ~/.mango/config.json. The API key is stored in plaintext — set appropriate file permissions. The key is masked (sk-a****...) whenever displayed.

Development

Flat package main on Cobra, one file per concern:

main.go    entrypoint
root.go    root command, version
config.go  config + config/view/models commands
commit.go  prompt building, API call, git helpers, commit command
colors.go  ANSI helpers

Tests exercise real behavior (temp HOME for config, httptest for the API) rather than mocks.

The devenv shell prints its command menu on entry (run menu to see it again): build, test-code, test-coverage, test-race, bench, fmt, vet, lint, ci, clean.

Releasing

Versions are git tags (SemVer). In the devenv shell, bump <major|minor|patch> bumps and pushes a tag after a confirmation prompt; pushing a vX.Y.Z tag triggers GitHub Actions to build binaries (Linux/macOS/Windows, amd64 + arm64) and publish a release.

Manual: git tag v1.2.3 && git push origin v1.2.3. Rollback: git tag -d v1.2.3 && git push origin --delete v1.2.3 (delete the GitHub release by hand if it already built).