Skip to content

Using GitUp Search

Pierre-Olivier Latour edited this page Nov 23, 2017 · 3 revisions

Overview

While in Map view, use the search field to search for branches and tags by their name, or commits by their message, author or committer, and even diff content.

Select a search result to jump to it in the Map.

IMPORTANT: Searching commit diffs must first be enabled on a per-repository basis from the "Repository" > "GitUp Settings..." menu. Be aware that indexing diff commits in large repos can take a long time (GitUp can process anywhere from 3,000 to 10,000 commits per minute depending on the repo complexity and hard drive I/O performance).

Search Syntax

  • To search for multiple terms, enter them separated by spaces (equivalent to AND), AND (uppercase) or OR (uppercase)
    • e.g. alice AND bob and alice bob both return all commits containing "alice" and "bob", while alice OR bob returns all commits containing either "alice" or "bob"
  • To exclude a term, prefix it by NOT (must be uppercase)
    • e.g. alice NOT bob returns all commits containing "alice" but not "bob"
  • You can also search for term prefixes by using *
    • e.g. bob* returns all commits containing "bob", "bobby", etc...
  • To search for entire sentences, use double quotes
    • e.g. "alice beats bob" returns all commits containing exactly "alice beats bob"
  • More complex queries can be built using parenthesis
    • e.g. (bob* OR alice) AND "fixed bug"

Note that search is both case-insensitive and diacritic-insensitive.

Keyboard Shortcuts

  • Cmd-F to set keyboard focus to search field while in Map view
  • Arrow down while in search field to switch to result list

Tips

  • You can enter Quick View for the selected result by pressing Spacebar