noidea 1.1.0

AI commit messages that pre-fill your git editor — Claude-powered, conventional-commits aware, learns your repo's style.

noidea

Because you shouldn't have to think about commit messages.

Stages your diff, sends it to an AI, and pre-fills your commit editor — so you never have to write a commit message again.

---

Why noidea?

There are plenty of AI commit tools. noidea is the one that fits the way you already work:

• Writes in your repo's voice, not generic AI boilerplate. Before generating, noidea reads how your repo already commits — its scope vocabulary, body habits, subject length, gitmoji or not — and matches it. Your history stays consistent instead of looking like a bot dropped in.
• Spends pennies and milliseconds on trivial commits. Small diffs go to a fast, cheap model; only substantial changes escalate to the strong one — automatically, and it tells you which it chose. No paying premium rates to commit a typo fix.
• Never auto-commits — you always get the last word. It pre-fills your editor on git commit. No new command to remember, no message committed behind your back. Edit or delete it like any draft.
• Terminal-native and private by design. A small, MIT-licensed Python CLI built to a strict safety-first style guide. Your diffs go straight to your chosen model and nowhere else.

Quick Start

pipx install noidea
noidea init

That's it. Every git commit now opens your editor with a suggested message pre-filled.

Requires pipx. Alternatively: pip install noidea

API Key Setup

noidea needs an Anthropic API key. Three options (checked in order):

Method	Command
Keyring (recommended)	noidea keys add
Environment variable	export ANTHROPIC_API_KEY=sk-ant-...
.env file	ANTHROPIC_API_KEY=sk-ant-... in a .env file

Commands

Command	Description
noidea init	Install the prepare-commit-msg hook. Backs up any existing hook. Respects core.hooksPath.
noidea suggest	Generate a commit message from the staged diff and print it.
noidea status	Show current config, API key status, and hook installation.
noidea keys	Manage API keys in the system keyring (show / add / remove).
noidea test	Send a test message to Claude to verify connectivity.
noidea update	Upgrade noidea via pipx (falls back to pip).
noidea --version	Print the current version.

noidea suggest options

-F, --file TEXT    Write message to file instead of stdout (used by the hook)
-M, --model TEXT   Override the model used for generation

Config

Two optional config levels — both are config.json files:

• User: ~/.noidea/config.json — applies everywhere
• Repo: <repo>/.noidea/config.json — overrides user config

Precedence: built-in defaults → user config → repo config.

{
  "llm": {
    "max_tokens": 1024,
    "small_model": "claude-haiku-4-5",
    "large_model": "claude-sonnet-4-6",
    "context_limit": 600000,
    "temperature": 1.0,
    "learn_commit_style": true,
    "system_prompt": "Your custom prompt here"
  }
}

Falls back to built-in defaults if no config file exists. The default prompt follows conventional commits style (feat/fix/refactor/etc.) with a 72-character subject line limit. Smaller diffs use small_model (Haiku) for speed; larger diffs automatically switch to large_model (Sonnet). temperature controls output creativity (0.0–1.0); the default of 1.0 maximises variety.

Repo-native style learning

learn_commit_style (on by default) samples your recent git log and matches the repo's own conventions — its scope vocabulary, whether commits carry a body, typical subject length, and gitmoji usage — so suggestions read like your project's existing commits rather than generic boilerplate. It activates automatically once a repo has at least 5 commits; below that it stays out of the way. Set "learn_commit_style": false to disable it.

Contributing

See CONTRIBUTING.md for development setup and guidelines. This project follows TigerStyle for coding standards.

Requirements

• Python 3.10+
• Anthropic API key