---
name: "git-branchless-record"
section: "1"
platform: "linux"
package: "git-branchless"
version: "0.11.1-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-branchless-record"
---

# git-branchless-record(1)

Create a commit by interactively selecting which changes to include

## NAME

record - Create a commit by interactively selecting which changes to include

## SYNOPSIS

**record** \[**-m**\|**--message**\] \[**--fixup**\] \[**-i**\|**--interactive**\] \[**-c**\|**--create**\] \[**-d**\|**--detach**\] \[**-I**\|**--insert**\] \[**-s**\|**--stash**\] \[**--untracked**\] \[**-h**\|**--help**\]

## DESCRIPTION

Create a commit by interactively selecting which changes to include

## OPTIONS

- **-m**, **--message** *\<MESSAGES\>*

  The commit message to use. Multiple messages will be combined as separate paragraphs, similar to \`git commit\`. If not provided, you will be prompted to provide a commit message interactively

- **--fixup** *\<COMMIT\_TO\_FIXUP\>*

  A commit to "fix up". The message will be prefixed with \`fixup!\` following the supplied commit, suitable for use with \`git rebase --autosquash\`

- **-i**, **--interactive**

  Select changes to include interactively, rather than using the current staged/unstaged changes

- **-c**, **--create** *\<CREATE\>*

  Create and switch to a new branch with the given name before committing

- **-d**, **--detach**

  Detach the current branch before committing

- **-I**, **--insert**

  Insert the new commit between the current commit and its children, if any

- **-s**, **--stash**

  After making the new commit, switch back to the previous commit

- **--untracked** *\<UNTRACKED\_FILE\_STRATEGY\>*

  How should newly encountered, untracked files be handled?\

  *Possible values:*

  - •

    add: Add all untracked files

  - •

    disable: Disable all untracked file checking and processing

  - •

    prompt: Prompt the user about how to handle each untracked file

  - •

    skip: Skip all untracked files

- **-h**, **--help**

  Print help (see a summary with '-h')