# Install aicommits with Homebrew

Writes your git commit messages for you with AI. Version 3.4.0 via Homebrew; verified 2026-05-20.

## Install

```sh
sudo av install brew:aicommits
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install aicommits
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:aicommits
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/aicommits>
- **Version:** 3.4.0
- **Source summary:** Writes your git commit messages for you with AI
- **Homepage:** <https://github.com/Nutlope/aicommits>
- **Repository:** <https://github.com/Nutlope/aicommits>
- **Upstream docs:** <https://github.com/Nutlope/aicommits>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/aicommits/-/aicommits-3.4.0.tgz>
- **Last updated:** 2026-05-20T00:28:02Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- aic (cli)
- aicommits (cli)
- aic (alias)
- aicommits (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.4.0
- Package-manager updated: 2026-05-20
- Local data: ok
- Upstream repository: https://github.com/Nutlope/aicommits
- info: No cached GitHub release or tag data was available.
## Project history and usage

aicommits is a JavaScript/Node command-line utility that writes Git commit messages from staged diffs using AI models. Its README presents it bluntly as a CLI that writes commit messages so users do not have to.

### Project history

The public npm package and GitHub repository both date to February 2023, placing aicommits among the early wave of ChatGPT-era developer CLIs. The project was initially centered on OpenAI-backed commit-message generation and later expanded provider support to TogetherAI, Groq, xAI, OpenRouter, Ollama, LM Studio, and custom OpenAI-compatible endpoints.

The tool grew from a simple `git add` plus `aicommits` workflow into a small Git integration package: it supports selectable message formats, multiple generated recommendations, custom prompts, clipboard output, direct commit invocation, and a prepare-commit-msg hook.

### Adoption history

The official README documents npm installation and a global CLI, while the Homebrew formula packages the same tool for brew users. The GitHub repository had over 9,000 stars when checked through the official repository API.

The npm registry listed 98 published versions and latest version 3.4.0; Homebrew also listed 3.4.0 as the stable formula version.

### How it is used

The normal workflow is `git add <files...>` followed by `aicommits`; unknown flags are passed through to `git commit`. Users can also install a prepare-commit-msg hook so Git opens the generated message in the configured editor before committing.

Configuration is created by `aicommits setup` in `~/.aicommits`, and the README also documents environment-variable configuration for API keys and provider settings.

### Why package nerds care

aicommits became one of the recognizable package names in the AI commit-message subgenre: a tiny npm-installed executable, a memorable binary alias `aic`, a Homebrew formula, and a configuration dotfile. It is also directly named by aicommit2 as an architectural inspiration.

### Timeline

- 2023: npm package record created and GitHub repository opened.
- 2023: Tool ships as a global npm CLI for AI-generated Git commit messages.
- 2026: npm and Homebrew list 3.4.0 as current/latest.

### Related projects

- aicommit2, which cites aicommits as inspiration.
- Git commit hooks, especially prepare-commit-msg.
- OpenAI-compatible API providers and local model runners such as Ollama and LM Studio.

### Sources

- <https://formulae.brew.sh/api/formula/aicommits.json>
- <https://github.com/Nutlope/aicommits>
- <https://registry.npmjs.org/aicommits>


## Security Notes

No matching local secret-handling manifest was found for aicommits. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.aicommits

## Credential files

- Unix: ~/.aicommits
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** aicommits
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [aicommit](https://www.automicvault.com/pkg/brew/aicommit/) - Shares av.db curated category or tags: ai, cli, commit-messages, developer-tools, git.
- [aicommit2](https://www.automicvault.com/pkg/brew/aicommit2/) - Shares av.db curated category or tags: ai, cli, commit-messages, developer-tools, git.
- [commitlint](https://www.automicvault.com/pkg/brew/commitlint/) - Shares av.db curated category or tags: cli, commit-messages, developer-tools, git, version-control.
- [vibecheck](https://www.automicvault.com/pkg/brew/vibecheck/) - Shares av.db curated category or tags: ai, cli, developer-tools, git, version-control.
- [braid](https://www.automicvault.com/pkg/brew/braid/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [cig](https://www.automicvault.com/pkg/brew/cig/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [codeberg-cli](https://www.automicvault.com/pkg/brew/codeberg-cli/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [commitizen](https://www.automicvault.com/pkg/brew/commitizen/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [git-split-diffs](https://www.automicvault.com/pkg/brew/git-split-diffs/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, control, developer, developer-tools, git.

## Combined YAML source

View the package source record on GitHub. [combined/aicommits.yml](https://github.com/automic-vault/db/blob/main/combined/aicommits.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
