Back
GitoryxGitoryx

Open a Repository from the Terminal with Gitoryx

Every visual Git client worth its salt has a CLI shortcut: fork ., code ., gitkraken ., and now Gitoryx does too. This guide shows you how to install and use the gitoryx command to open repositories instantly from your terminal.

Beginner4 min readUpdated

On this page

What is the gitoryx CLI command?

The gitoryx CLI command opens any Git repository in the Gitoryx desktop app directly from your terminal. Run gitoryx . to open the current directory, or gitoryx /path/to/repo for any repository on your machine.

The short version

  1. 1Open Gitoryx → Settings → About → Install Command
  2. 2Open your terminal and navigate to a Git repository
  3. 3Run gitoryx . to open the repo in Gitoryx

Why it matters

You're deep in your terminal, navigating between repositories, running builds and tests, and every time you need the visual Git client, you have to switch to Finder, locate the folder, and drag it into the app. It breaks your flow.

Every visual Git client worth its salt has a CLI shortcut: fork ., code ., gitkraken .. It's the bridge between the terminal and the GUI, and without it, the app feels disconnected from the developer's real workflow.

Where it usually goes wrong

  • Thinking you need to open the app manually every time
  • Not knowing the CLI command exists after installing the app
  • Forgetting to install the CLI command from the app settings

The gitoryx command, step by step

  1. Step 1: Install the CLI command from Gitoryx

    Open Gitoryx, go to Settings → About, and click "Install Command". This creates the gitoryx command in /usr/local/bin/ so it's available in every terminal session. You may be prompted for your administrator password.

    Tip: You only need to do this once. The command persists across app updates.

  2. Step 2: Open the current directory

    Navigate to any Git repository in your terminal and run gitoryx .: the repo opens in Gitoryx as a new tab, and the app window comes to the foreground.

    Terminal
    cd ~/projects/my-appgitoryx .
  3. Step 3: Open a specific path

    You can also pass an absolute or relative path to open a repository that isn't your current directory.

    Terminal
    # Absolute pathgitoryx /Users/me/projects/backend# Relative pathgitoryx ../other-repo
  4. Step 4: Launch Gitoryx even if it's not running

    The command works whether Gitoryx is already open or not. If the app isn't running, macOS launches it automatically and opens the repo once it's ready.

    Tip: If you have multiple repos open, the new one is added as a tab alongside your existing ones.

  5. Step 5: Uninstall the command (optional)

    If you ever want to remove the CLI command, go back to Settings → About and click "Uninstall Command". The gitoryx command is removed from your PATH.

Mistakes to avoid with the gitoryx command

Running the command before installing it
If you type gitoryx . without first installing the CLI from the app settings, your shell will say "command not found".
Fix: Open Gitoryx → Settings → About → Install Command.
Running it in a directory that isn't a Git repo
The command passes the path to Gitoryx, which expects a valid Git repository. Opening a non-repo folder will show an error in the app.
Fix: Make sure you're inside a Git repository (a directory containing a .git folder).
Permission denied when installing
The CLI is installed in /usr/local/bin/, which requires administrator access on macOS.
Fix: Click "Install Command" and enter your admin password when prompted by macOS.

The gitoryx command in Gitoryx

Gitoryx lets you type gitoryx . in any terminal and your repo opens instantly in a new tab, no Finder, no drag-and-drop.

  • Type gitoryx . from any terminal: your repo opens in a new tab instantly.
  • Works with your existing terminal workflow, no need to switch to Finder.
  • Install once from Settings → About → Install Command. No package manager needed.
  • Supports both . (current dir) and absolute/relative paths.
  • If Gitoryx is already running, the repo is added as a tab. If not, the app launches automatically.

Free plan · no account required · macOS, Windows and Linux

The gitoryx command: frequently asked questions

Does the CLI command work on Windows?
The CLI companion is currently available on macOS only. Windows support is planned for a future release.
Do I need to reinstall the command after updating Gitoryx?
No. The CLI command is a standalone script installed in /usr/local/bin/ and is not affected by app updates.
Can I use `gitoryx` as a Git difftool or mergetool?
Not yet. The current CLI only supports opening repositories. Integration as a difftool/mergetool is on the roadmap.
What happens if I run `gitoryx .` outside a Git repo?
Gitoryx will attempt to open the directory and display an error if it doesn't contain a valid Git repository.
All Git tutorials →
Gitoryx

Stop fighting Git. Start shipping.

Download the fast, native Git client that developers actually enjoy using.

v1.3.0 · macOS 12+ (Apple Silicon or Intel) · Windows 10+ · Linux x86_64