AI Commit Messages

  • Desktop app
  • All plans

What it does

Writes one clean commit message from the real git diff of the files you are about to commit. Click the sparkle on the commit message field, optionally type a rough draft ("fix temp pdf"), and the Commit writer bubble proposes a Conventional Commits message that respects your per-project format rules ("always bug(TICKET) : Description"). It stacks on a free, deterministic pre-fill of the field. By default (Agents write their own commit message, on), the agent itself puts its commit line in the field on the first turn that changes files, once per commit cycle, through its AgentsRoom tools and following your format rules; until it does, only a backlog ticket's type and title pre-fill it (crediting a public backlog reporter by first name), and a message you typed by hand is never replaced. With that setting off, the field falls back to the classic guess from the agent's session title or latest notification. The diff is sent only when you click, and is never stored.

Video (1 min 20 s): AI Commit Messages, shown in the real app. An agent fixes a bug and changes three files, the files show up under its name in the Changes tab, the commit box says "wip", one click on the sparkle with the draft "fix coupon total" brings back a clean "fix:" message with a short body, and Use this message puts it in the box, ready to commit.

Where to find it

  • Right panel > Changes tab: the sparkle button (AI commit message) in the top right corner of the commit message box, next to the Expand button that opens the message in a full-screen editor. It opens the Commit writer bubble ("Turns your changes into a commit message") above the box. The box sits at the bottom of the tab, under the file list and above "Will commit N/N files from <agent>".
  • Review mode: the same sparkle on its commit field.
  • Video tutorial: a small play icon in the header of the Commit writer bubble, just before the gear of the format rules (tooltip "Watch the video tutorial on YouTube"), opens the video on YouTube in your browser.
  • Format rules: the gear in the corner of the Changes tab commit box (Commit format rules), which asks Global rules or Project rules and opens the matching settings; the gear in the bubble; Project settings > Git (project rules), Settings > Git (global rules), Folder settings > Git (folder rules).
  • Settings > Git is the tab for everything about commits made from AgentsRoom: Agents write their own commit message, Commit format rules, Attach agent conversation to commit and Automatically update .gitignore. Project settings > Git holds the project overrides.

How to use it

  1. With pending changes, click the sparkle. The bubble opens, pre-filled with anything already typed.
  2. Type a short intent or send empty: the diff of the scoped files (per-agent filter and excluded files respected) is read locally and sent.
  3. The proposal arrives as a card: Use this message fills the field, Try another regenerates.
  4. Commit as usual. What you applied is remembered like manual input and survives filter changes.

To read or edit a long message (a subject plus a body, yours or the agent's), drag the top edge of the box upwards, anywhere along it ("Drag to resize the commit message box"); the height is remembered for every project, and a double-click on that edge restores the default. Or click Expand: the Commit message editor opens full screen with the same sparkle, Commit and Commit + Close buttons; Cmd/Ctrl+Enter commits, Esc or Close closes. Every keystroke there is the same hand-typed draft as in the box.

When a commit is refused (a pre-commit hook fails, git stops), a Commit failed block shows the whole output of git and the hooks, selectable and scrollable. It stays until you click Dismiss, commit again or quit the app, even if you switch tab or project and come back, or the hook made the files disappear from the list. Copy and Dismiss are icons in the block's header. Ask an agent to fix is one button: it opens the list of the project's agents (Choose an agent, with a search field past five agents, the agent whose files you were committing first) and picking one sends the output right away, started if needed, asking it to fix the cause, keep the hooks enabled and not commit or push without your approval; "Errors sent to the agent" confirms. When a Git merge is in progress, committing only some of the files is refused by Git: the block then says so in plain words above the output ("A Git merge is in progress...") and nothing is staged; finish or abort the merge (or ask the agent), then commit again. Committing all the files concludes the merge as Git does. Commit + Close never closes the console when the hook refused the commit.

Rules once, forever: click the gear, write your team's convention in plain text (up to 1,000 characters), Save rules. Every generation on that project follows it; the rules sync with your account across machines.

Settings

  • commitFormatRules (global, Settings > Git > Commit format rules; project override in Project settings > Git; folder default in Folder settings > Git): free-form rules the generator must follow. The nearest level wins: project, then folder chain, then global.
  • agentCommitMessage (global, Settings > Git > Agents write their own commit message, on by default; project override in Project settings > Git; per-agent pin in Edit agent > Commit message in the Changes tab): whether the agent writes the commit message itself or the field guesses one from its session title. The nearest level wins: agent, then project, then global. When off, the agent's git_set_commit_message tool is refused.

Agent tools (MCP)

  • git_set_commit_message({ message }): the agent pre-fills the commit field of its own pill in the Changes tab with its final commit line (optional body after a blank line). It commits nothing and runs no git command; a hand-typed message stays (the answer then says keptUserDraft); refused when agentCommitMessage is off for that agent or project. The answer carries the format rules in force so the agent can check its line before calling. One write per commit cycle: the box is filled only when empty (a later call changes nothing and answers alreadySet), and a commit of that agent's files from the desktop (or /clear on the agent) clears it, which starts a fresh cycle. One exception: when a later turn changed what the uncommitted work is (a feature added or removed, the first change reverted), the agent calls again with replace: true and its corrected line overwrites its own earlier message (answer replaced); a hand-typed message is still never replaced. A commit made from the phone does not clear it.

Providers

Independent of the agent CLI: it reads the git diff, not the agent, so it behaves the same whatever produced the changes. The pre-fill's session titles and ticket titles are provider-agnostic too.

Mobile

Partly. The phone's Changes screen has the same pre-fill as the desktop, in the same order: the message the agent posted with git_set_commit_message, then the ticket type and title (with reporter credit), then the session title, then the notification. The Agents write their own commit message setting is honoured on the phone (agent pin, then project, then global) but changed from the computer only. A refused commit opens a sheet on the phone with the same output, Copy output and Ask an agent to fix. The AI bubble, the resize handle and the full-screen editor are not on the phone: its message field simply grows with the text.

Limits

  • Monthly allowance per plan: 5 generations on Free, 100 on Plus, unlimited on Pro (a fair-use ceiling applies and is not displayed). One free try without an account. Failed generations do not count; counters reset each calendar month. Your own OpenAI key keeps it running past the allowance, see Bring Your Own OpenAI Key.
  • The diff is truncated to about 15,000 characters before sending.
  • Language: the draft's language; with an empty draft, the interface language.
  • Only the short draft and the produced message are logged for quota counting, never the diff.

Common questions

  • What does it read? The diff of the files scoped to the commit, collected on your machine, sent only on click.
  • Is my diff stored? No. Used for that one generation, then discarded.
  • I typed part of the message, will it be overwritten? No: the proposal applies only when you click Use this message, and manual input is remembered per agent filter.
  • How is this different from the automatic pre-fill? The pre-fill is free, unlimited and reads no diff (ticket, session title, notification). The AI reads the actual changes.
  • Which message ends up in the box? In this order: what you typed by hand, then the line the agent posted with git_set_commit_message, then the backlog ticket (type and title, reporter credited), then the session title, then the latest notification. With Agents write their own commit message on, the session title and notification guesses are skipped.
  • Why did my agent say its commit line in the chat instead of filling the box? Either you had typed a message by hand (it is never replaced), or the setting is off for that agent, project or globally: the agent then gives its line in its answer.
  • My agent's later turns no longer update the commit box. On purpose since 1.188.0: before, an agent working over several turns rewrote the box every turn and erased the previous message. The first message stays until you commit that agent's files from the desktop or /clear the agent; the agent keeps giving its current line in its answer. Edit the box by hand if you prefer the newer line.
  • How do I get AgentsRoom to write my commit message? Open the Changes tab, click the sparkle in the top right corner of the commit message box, type a rough draft (or nothing) and press Enter, then click Use this message. The message is generated from the real diff of the files you are committing; the commit itself stays your click. Video: https://youtu.be/NDs2A1qAMIQ
  • My commit failed because of a hook: how do I get the full error, or have it fixed? The Commit failed block under the commit box keeps the complete output until you dismiss it. Copy output, or Ask an agent to fix to hand it to an agent of the project, which is told to fix the cause without disabling the hooks. Same on the phone.
  • Why does my commit say "A Git merge is in progress"? Git refuses to commit a selection of files while a merge is unfinished. Nothing was changed: finish or abort the merge, or commit all the files to conclude it, then commit again.
  • How do I change the commit format for one project only, or for all of them? In the Changes tab, click the gear in the top right corner of the commit message box, then Global rules (every project, Settings > Git) or Project rules (this project only, Project settings > Git). The entry whose rules apply right now is checked.
  • Which format? Conventional Commits (feat, fix, refactor, chore, docs, style, perf, test), subject under 72 characters, short body only when needed; your rules take priority.
  • Is there a video that shows it? Yes, 1 min 20 s, filmed in the real app: https://youtu.be/NDs2A1qAMIQ. The play icon in the header of the Commit writer bubble opens it too.