October 11-13, 2022

GitKon 2022

GitKraken Client Documentation

Terminal

Open the terminal to use Git CLI commands while still viewing the graph.

To get started open up a repository and click the terminal button in the toolbar, from the new tab view by clicking New Terminal Tab, or by searching for "terminal" in the command palette.

Open a Terminal:

  • From the "New Terminal Tab" button in a New tab
  • With Ctrl/Cmd + T when inside a Terminal tab
  • From the Command Palette (Ctrl/Cmd + P)

Terminal Commands

Git Commands and Auto-complete

Most Git commands are supported and will appear in the Terminal’s auto-complete suggestions, start typing git to see them.

Auto-complete suggestions will also appear for flags.

Note: Other auto-complete programs can cause GitKraken CLI’s auto-complete suggestions to not work. You may need to uninstall or disable these programs before using the Terminal.

GK Commands

You can access GitKraken CLI specific commands by typing gk.

As well as suggestions for additional parameters.

Different views can be accessed using the gk CLI program:

  • gk panel: toggles the visualization panel. Also has parameters to reposition the panel top/bottom/left/right.
  • gk graph: shows the graph view. Same behavior as the gk panel, but additionally it will return to the graph if you’re in a different view, and has subcommands for toggling the graph columns with the keyboard.
  • gk history and gk blame: opens the history/blame panel for a specific file.
  • gk diff: shows changes between commits. If no SHAs are provided, it will use your WIP and HEAD. If only one SHA is provided, it will be compared with HEAD.
  • gk --help: shows the list of gk commands.


Toolbar

A toolbar above the panel will display the current repo name, branch, tag, and number of changes pending to pull/push. Clicking this toolbar will also toggle the panel on/off.


Terminal Preferences

Navigate to Preferences > Terminal to change your Terminal preferences.

Setting the default terminal on Mac and Linux

ZSH and Bash are currently supported for Mac and Linux. To switch shells you’ll need to set the new shell as default in your operating system settings and restart your computer for auto-complete to continue working as expected.

Setting the default terminal on Windows

PowerShell and Bash are currently supported for Windows. To switch shells, adjust the Default Terminal under Preferences > Terminal.

Have feedback about this article? Did we miss something? Let us know!
On this page