gitahead / gitahead

Understand your Git history!

Please Note!

GitAhead is no longer under active development. Low-level maintenance and bug fix releases will be made as necessary for the foreseeable future, but no new features or major changes are planned at this time. Please consider continuing development in a rebranded fork for anything other than trivial changes.

GitAhead - Understand Your History

GitAhead is a graphical Git client designed to help you understand and manage your source code history. It's available as a pre-built binary for Windows, Linux, and macOS, or can be built from source by following the directions below.

Build Environment

• C++11 compiler
  • Windows - MSVC >= 2017 recommended
  • Linux - GCC >= 6.2 recommended
  • macOS - Xcode >= 10.1 recommended
• CMake >= 3.3.1
• Ninja (optional)

Dependencies

External dependencies can be satisfied by system libraries or installed separately. Included dependencies are submodules of this repository. Some submodules are optional or may also be satisfied by system libraries.

External Dependencies

• Qt (required >= 5.9)

Included Dependencies

• libgit2 (required)
• cmark (required)
• git (only needed for the credential helpers)
• libssh2 (needed by libgit2 for SSH support)
• openssl (needed by libssh2 and libgit2 on some platforms)

Note that building OpenSSL on Windows requires Perl and NASM.

How to Build

Initialize Submodules

git submodule init
git submodule update

Build OpenSSL

# Start from root of gitahead repo.
cd dep/openssl/openssl

Win:

perl Configure VC-WIN64A
nmake

Mac:

./Configure darwin64-x86_64-cc no-shared
make

Linux:

./config -fPIC
make

Configure Build

# Start from root of gitahead repo.
mkdir -p build/release
cd build/release
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ../..

If you have Qt installed in a non-standard location, you may have to specify the path to Qt by passing -DCMAKE_PREFIX_PATH=<path-to-qt> where <path-to-qt> points to the Qt install directory that contains bin, lib, etc.

Build

ninja

License

GitAhead is licensed under the MIT license. See LICENSE.md for details.

gitahead's Issues

Show rename/copy in fast-forward

@hackhaslam commented on Mar 18, 2016, 9:01 PM UTC:

Git shows renames/copies in its fast-forward output. We only show added/deleted pairs. It's not just a matter of running the similarity check since checkout doesn't know how to handle renames and copies.

This issue was moved by shanegramlich from stinb/gitahead#21.

Untracked files don't load in diff view

@hackhaslam commented on Jun 2, 2016, 10:21 PM UTC:

Untracked files just show the file header. They should start closed but load the file when expanded.

This issue was moved by shanegramlich from stinb/gitahead#31.

(Win) Installer should have an option to start the app

@hackhaslam commented on Sep 2, 2016, 7:54 PM UTC:

The Windows installer needs a final page with a check box to start the application.

This issue was moved by shanegramlich from stinb/gitahead#41.

Add option to save search queries

@hackhaslam commented on Jul 12, 2016, 8:25 PM UTC:

Requested by Kevin McKenna ([email protected]).

This issue was moved by shanegramlich from stinb/gitahead#32.

Add option to show all branches in the commit list

@hackhaslam commented on Jun 11, 2015, 7:05 AM UTC:

This should probably be the default. Mostly works fine except for the graph. The graph logic needs to be reworked so that any node can be a root.

This issue was moved by shanegramlich from stinb/gitahead#6.

Implement autocomplete for pathspec combo box

@hackhaslam commented on Mar 18, 2016, 8:52 PM UTC:

Autocomplete only works in the first column. There's a related problem with pressing enter that clears the field.

This issue was moved by shanegramlich from stinb/gitahead#17.

Add swift lexer

@hackhaslam commented on May 24, 2016, 11:18 PM UTC:

Scintillua doesn't have a swift lexer yet. We should add it and then try to submit it back upstream.

This issue was moved by shanegramlich from stinb/gitahead#28.

Fetch/push asynchronously

@hackhaslam commented on Mar 18, 2016, 8:13 PM UTC:

Currently the interface can become slightly unresponsive right after pressing fetch/pull/push because the transfer happens synchronously and yields to the event loop in the callbacks. The callbacks aren't called quickly enough to look truly responsive.

This issue was moved by shanegramlich from stinb/gitahead#16.

Open submodule on double-click

@hackhaslam commented on Mar 18, 2016, 7:59 PM UTC:

Submodules in the file list, diff view, and tree view (at least) should be double-clickable to open the module in a new window.

This issue was moved by shanegramlich from stinb/gitahead#13.

Add submodule menu

@hackhaslam commented on Mar 18, 2016, 8:01 PM UTC:

The submodule menu would be the natural place to put actions like update. It could also have a list of submodules to open.

This issue was moved by shanegramlich from stinb/gitahead#14.

Evict stale editor contents to reclaim memory

@hackhaslam commented on Aug 23, 2016, 6:55 PM UTC:

Really big diffs can consume too much memory after they're fully loaded. It might be nice to evict contents from the oldest editors after a certain number get loaded.

This issue was moved by shanegramlich from stinb/gitahead#34.

Changing the file list selection with the keyboard doesn't jump to the file in the diff view.

@hackhaslam commented on Jan 25, 2015, 6:32 AM UTC:

The naive implementation, where the diff view responds to the selection change, conflicts with the diff view signaling the file list to update selection on scroll.

This issue was moved by shanegramlich from stinb/gitahead#2.

Read/write search index to disk through memory mapped files?

@hackhaslam commented on Aug 31, 2016, 5:14 AM UTC:

The performance impact needs to be investigated.

This issue was moved by shanegramlich from stinb/gitahead#38.

Index path components

@hackhaslam commented on Mar 18, 2016, 8:53 PM UTC:

Individual elements of a path need to be indexed individually so that they can be searched in any combination.

This issue was moved by shanegramlich from stinb/gitahead#18.

Show detached HEAD in branch menu

@hackhaslam commented on Jun 11, 2015, 7:03 AM UTC:

The branch popup menu should have a "HEAD" or "Detached HEAD" item when the HEAD is detached. It should be selected by default.

This issue was moved by shanegramlich from stinb/gitahead#5.

Add amend commit menu item

@hackhaslam commented on Aug 26, 2016, 6:16 PM UTC:

The functionality already exists. It just needs to be exposed as a menu action.

This issue was moved by shanegramlich from stinb/gitahead#36.

Show conflicted regions in diff view

@hackhaslam commented on Sep 6, 2016, 6:31 AM UTC:

Conflicts currently show in the diff view as a file header with a '!' status. It would be nice to show each conflicted region as a hunk with options to accept ours, theirs, or edit.

This issue was moved by shanegramlich from stinb/gitahead#42.

Start merge dialog with focus on the accept button

@hackhaslam commented on Sep 20, 2016, 4:48 AM UTC:

The merge dialog currently starts with the focus in the text area. Pressing return inserts a new line. I always want to hit enter to accept the dialog. I would rather click in the text area if I want to edit the message.

This issue was moved by shanegramlich from stinb/gitahead#44.

Add option to show reflogs in log view

@hackhaslam commented on Mar 18, 2016, 8:54 PM UTC:

I imagine a reference popup menu that also has an option to get back to the regular log.

This issue was moved by shanegramlich from stinb/gitahead#19.

File list checks don't display correctly when inactive.

@hackhaslam commented on Jan 25, 2015, 6:36 AM UTC:

This looks like an issue with the Qt Mac style on Yosemite. The check mark is white instead of the normal black for inactive check marks. The issue only affects checks drawn in item views.

This issue was moved by shanegramlich from stinb/gitahead#3.

Enable type to search in the reference list

@hackhaslam commented on Aug 24, 2016, 9:03 PM UTC:

The reference list combo box should be editable so that typing to search for a matching reference works.

This issue was moved by shanegramlich from stinb/gitahead#35.

Multiple repos open on Windows

@groke commented on Apr 28, 2016, 3:48 PM UTC:

You asked me about this last week so I've been playing with having multiple repositories open in GitAhead on Windows trying to determine what feels native. Here is what I think feels natural.

• A single instance should coorespond to one open repo. If the user opens a repo from the file menu it should replace the currently open repo
• In order to have a second repo open they should launch a new instance of GitAhead
• Closing gitahead either from the file menu or through the X should just close the current instance only
• When gitahead is launched from the icon it should start in the selector screen, not with the previously opened project. Although that can be added as an option or checkbox on the selector

This issue was moved by shanegramlich from stinb/gitahead#24.

Add remote menu

@hackhaslam commented on May 5, 2016, 9:22 PM UTC:

Add remote menu with shortcuts for fetch, pull, and push. They should probably have some way to specify a remote.

This issue was moved by shanegramlich from stinb/gitahead#27.

File discard button doesn't work

@hackhaslam commented on Sep 20, 2016, 7:55 PM UTC:

Fails under some unknown circumstances.

This issue was moved by shanegramlich from stinb/gitahead#45.

Images don't collapse in diff view

@hackhaslam commented on Jun 2, 2016, 10:19 PM UTC:

Images can't be collapsed by toggling the disclosure button.

This issue was moved by shanegramlich from stinb/gitahead#30.

Fix silent error when user tries to add a new branch with a space in the name

@shanegramlich commented on Sep 23, 2016, 9:52 PM UTC:

Desired Behavior:
-No branch created
-Error message thrown in log

This issue was moved by shanegramlich from stinb/gitahead#52.

Add filtering by file on command line

@hackhaslam commented on May 30, 2016, 5:20 AM UTC:

The command line argument should be interpreted as the path to a repo first. If it's not a repo but the current working directory is, then we should open the working directory repo and try to filter the pathspec by the argument.

This issue was moved by shanegramlich from stinb/gitahead#29.

Submodule update after pull doesn't work when the merge commit message dialog pops up

@hackhaslam commented on Sep 22, 2016, 4:15 AM UTC:

It looks like the submodule update proceeds immediately after popping up the dialog. It should happen after the dialog has been accepted and the commit has been recorded.

This issue was moved by shanegramlich from stinb/gitahead#50.

Lib2Git has infinite loop when failing to connect to remote git repo

@truthuntold commented on Jun 15, 2015, 4:01 PM UTC:

This happened when I didn't have the correct public key on github and tried to pull. The first time it gives an error. The second time it goes into the loop.

Method - static int _git_ssh_setup_conn
...
Loop - while (error == GIT_EAUTH)
...
Line - error = _git_ssh_authenticate_session(session, cred);

This issue was moved by shanegramlich from stinb/gitahead#7.

Checkout fails when there are modified submodules

@hackhaslam commented on Jul 31, 2015, 7:45 PM UTC:

I don't know if this is a bug in libgit2 of an option that needs to be set.

This issue was moved by shanegramlich from stinb/gitahead#8.

(Win) Implement fake default signature

@hackhaslam commented on Sep 22, 2016, 3:31 PM UTC:

Windows doesn't have an implementation for faking the default signature. It requires platform-specific logic to get the user name from the operating system.

This issue was moved by shanegramlich from stinb/gitahead#51.

(Win) Editor windows don't have a menu bar or shortcuts

@hackhaslam commented on Sep 2, 2016, 7:46 PM UTC:

Editor windows don't have the menu bar and its the shortcuts on Windows. They should maybe have their own menu bar or a toolbar or at least the save shortcut.

This issue was moved by shanegramlich from stinb/gitahead#40.

Draggable tabs

@hackhaslam commented on Jul 29, 2016, 9:26 PM UTC:

At the very least tabs should be draggable for reordering. It would also be nice to have the ability to drag tabs out into their own window, drop windows onto the tab bar to capture them as tabs, and drag tabs between windows.

This issue was moved by shanegramlich from stinb/gitahead#33.

Add ability to select and copy from the log

@hackhaslam commented on Sep 21, 2016, 8:50 PM UTC:

Ideally there should be both plain text and a nice HTML part that sort of emulates the style of the view.

This issue was moved by shanegramlich from stinb/gitahead#48.

Commit list selects first row after hiding 'uncommitted changes' item.

@hackhaslam commented on Jan 25, 2015, 6:29 AM UTC:

This is a problem when the user selects a different commit before the check for uncommitted changes finishes. It should stay on the commit selected by the user.

This issue was moved by shanegramlich from stinb/gitahead#1.

Pull doesn't respect the branch.<name>.rebase setting

@hackhaslam commented on Sep 21, 2016, 8:17 PM UTC:

It should probably also query the global pull.rebase setting.

This issue was moved by shanegramlich from stinb/gitahead#47.

Add status text to window title

@hackhaslam commented on Mar 24, 2016, 6:55 PM UTC:

The window title should have status text for special states like MERGING, REBASING, REVERTING, etc.

This issue was moved by shanegramlich from stinb/gitahead#22.

Navigate to commit links that aren't reachable from the current branch

@hackhaslam commented on Mar 18, 2016, 8:05 PM UTC:

Only links that are reachable from the current branch can be visited from a link. One possible solution would be iterate over all refs until we can reach the commit then change to that branch. A better solution might be to carry a reference hint with each link. Presumably that would be known at each site where links are created.

This issue was moved by shanegramlich from stinb/gitahead#15.

Recent repository list duplicate short names

@hackhaslam commented on May 2, 2016, 4:40 PM UTC:

The recent repository lists should show the relative name for duplicate entries. There should probably also be an option to show the full name.

This issue was moved by shanegramlich from stinb/gitahead#25.

Allow arbitrary refspec in the Push To... dialog

@hackhaslam commented on Aug 26, 2016, 6:19 PM UTC:

The ref combo box needs to allow an arbitrary refspec in addition to the type-to-find functionality that it needs elsewhere.

This issue was moved by shanegramlich from stinb/gitahead#37.

Config interface for submodules

@hackhaslam commented on Mar 18, 2016, 7:55 PM UTC:

The config interface should have a submodule section. It would be the natural place to add/remove submodules.

This issue was moved by shanegramlich from stinb/gitahead#11.

Add option to checkout current branch

@hackhaslam commented on May 2, 2016, 6:04 PM UTC:

There should be a new menu item with a shortcut to checkout the current branch. Of course it should be enabled whenever HEAD doesn't point to the current branch. The existing checkout branch item should also have shortcut.

This issue was moved by shanegramlich from stinb/gitahead#26.

Read/write search index to disk through memory mapped files?

@hackhaslam commented on Aug 31, 2016, 5:14 AM UTC:

The performance impact needs to be investigated.

This issue was moved by shanegramlich from stinb/gitahead#38.

Diff view incremental load is too coarse grained

@hackhaslam commented on Jan 29, 2015, 10:21 AM UTC:

The diff view incremental load has file granularity. Files that contain many hunks can cause a noticeable slowdown. The granularity should probably be changed to count hunks instead.

This issue was moved by shanegramlich from stinb/gitahead#4.

Show date in log view

@hackhaslam commented on Sep 21, 2016, 9:17 PM UTC:

Entries that are from previous days should show the date in addition to the time. Entries from today should still be just the time. It should be easy to do by changing the delegate to draw the date if the it's not today's date.

This issue was moved by shanegramlich from stinb/gitahead#49.

Save log to disk

@hackhaslam commented on Mar 18, 2016, 7:58 PM UTC:

The log should be saved to disk and restored when the repository is reopened. Then there would have to be an explicit clear button or something similar.

This issue was moved by shanegramlich from stinb/gitahead#12.

Add commit message spellcheck

@hackhaslam commented on Aug 13, 2015, 6:25 AM UTC:

Spellcheck and autocorrect are expected in the commit editor at least. It would also be nice to spellcheck added comments and string literals.

This issue was moved by shanegramlich from stinb/gitahead#9.

Throttle transfer progress updates

@hackhaslam commented on Mar 18, 2016, 8:59 PM UTC:

Transfers are actually limited by the update frequency and how long it takes to paint the changes in the log. Updates need to be throttled to only a few times per second.

This issue was moved by shanegramlich from stinb/gitahead#20.

(Win) Installer should include the VS2013 redistributable and install if necessary

@hackhaslam commented on Sep 13, 2016, 9:04 PM UTC:

Understand is a good example of how it should work.

This issue was moved by shanegramlich from stinb/gitahead#43.

Can't connect to remote host when through proxy

@hackhaslam commented on Sep 21, 2016, 3:12 PM UTC:

We may just need to enable proxy auto-detection:

QNetworkProxyFactory::setUseSystemConfiguration(true);

but that ought to be tested.

This issue was moved by shanegramlich from stinb/gitahead#46.