Gitfox
🌙

Commit Message Autocomplete

Gitfox 5 and later can suggest file paths, commit hashes, emoji, and issue references while you write a commit message.

Open the commit window, then type / at the start of a line or after a space to see the available commands. You can also type a command directly, followed by a search term like this /gbug.

Autocomplete commands

Command Example Inserts
/f /f README A file path relative to the repository root
/c /c fix or /c a1b2c3d An abbreviated commit hash
/g /g bug or /g sparkles A Gitmoji emoji
/i /i login or /i 123 An issue reference such as #123 or PROJ-123

Use ↑ and ↓ to select a suggestion, then press Return or Tab to insert it. You can also click a suggestion. Press Esc to dismiss the list.

Choosing a suggestion replaces the slash command and its search text. For example, choosing the bug emoji for Fix /g bug produces Fix 🐛.

File searches match filenames and paths. Commit searches match commit subjects or hash prefixes. Gitmoji searches match emoji, shortcodes, or descriptions. Type a command without a search term to browse suggestions.

Choose issue sources

Issue autocomplete searches the sources enabled for the current repository. Open Repository → Configure Issue Sources…, or click Configure Issue Sources… below the /i suggestions.

The dialog has two independent choices:

  • Issue tracker: select a Jira Cloud account, or choose None to leave it out. If you have not connected Jira yet, choose Add issue tracker account… to open account settings and follow the Jira Cloud setup steps. Return to this dialog and select the account after adding it.
  • Issues from the preferred Git remote: include issues from the repository’s GitHub, GitLab, GitLab Self-Managed, or Gitea remote. Add a matching service account first. Bitbucket issue search is not supported.

The preferred remote is the current branch’s upstream remote when configured, otherwise origin, otherwise the first available remote. You can search that remote and a Jira Cloud account together, or enable just one source. These choices are saved for each repository.

Type /i to browse recent issues, including open and closed issues, or add a title, number, or Jira key to narrow the search. Selecting an issue inserts its reference, such as #123 for a Git-hosted issue or PROJ-123 for Jira.

To turn references in commit messages into clickable URLs, use Commit Message Links.

If suggestions are missing

  • If the command list does not open, check that you are using Gitfox 5 or later and that / is at the start of a line or follows a space.
  • For issue suggestions, check Configure Issue Sources…. A Jira account must be selected for this repository even if it is already saved in Settings. Git-hosted issues need a supported preferred remote and a matching account.
  • Check that your account can access the issues and that you have an internet connection. If Settings shows an account error, reauthorize the account. Jira requires an API token without scopes; replace it if it has expired or been revoked.
  • Try a shorter search or enter the issue number or key. For Jira summary searches, try the start of a word. Suggestions are limited, so an issue missing from the initial list may appear after you narrow the search.