@taksumaq/aicommits

Tiny AI-powered Git commit assistant (10 kB on npm). Generates commit messages (and explanations) for your staged changes using the DeepSeek API.

Why this CLI?

• Lightweight: ~10.0 kB unpacked on npm.
• Zero-friction UX: aicommits (no subcommand) runs the default commit flow.
• Focused messages: scope to the staged files you select.
• Explain mode: aicommits explain summarizes what changed.
• One-time setup: stores config at ~/.config/aicommits/config.json (or $XDG_CONFIG_HOME/...).

Install

npm i -g @taksumaq/aicommits

Requires Node.js 18+. Check with node --version.

Configure

Save your API key (DeepSeek) to your user config:

aicommits config set DEEPSEEK_API_KEY=sk-your-key

Usage

Stage changes, then run:

git add <files...>
aicommits

Short aliases also work: aicommit, aicmt, aic.

Example of what you’ll see:

? Select files to include in this commit (3 staged total) › Space to select • Enter to confirm
 ◯ README.md
 ◉ package.json
 ◯ src/index.ts

🧠 Suggested commit message:
"Update package.json metadata and dependencies"

- Add description, keywords, author, and publish config
- Remove dotenv dependency and external build reference
- Reorganize fields for better readability
- Specify package manager as [email protected]"

? What do you want to do?
> ✅ Use this message and commit
  📝 Edit message before committing
  ❌ Cancel

📦 Committing 1 file(s): ""Update package.json metadata and dependencies"

• Checklist of staged files → pick one or many.
• AI suggests a message → use / edit / cancel.
• It commits exactly those files with that message.
• If other files remain staged, it offers another round.

Explain instead:

aicommits explain

Update

Check installed version:

aicommits --version

If not the latest version run:

npm update -g @taksumaq/aicommits

Useful extras:

aicommits config path                  # see where the config lives
aicommits config get DEEPSEEK_API_KEY  # print the stored value

Prefer an env var for a one-off shell?

export DEEPSEEK_API_KEY=sk-override-for-this-shell

License

MIT