GitoryxEvery 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.
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.
Common mistakes developers make with this:
Gitoryx: Gitoryx lets you type gitoryx . in any terminal and your repo opens instantly in a new tab — no Finder, no drag-and-drop.
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.
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.
You only need to do this once. The command persists across app updates.
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.
cd ~/projects/my-app
gitoryx .You can also pass an absolute or relative path to open a repository that isn't your current directory.
# Absolute path
gitoryx /Users/me/projects/backend
# Relative path
gitoryx ../other-repoThe 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.
If you have multiple repos open, the new one is added as a tab alongside your existing ones.
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.
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.
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).
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.
gitoryx . from any terminal — your repo opens in a new tab instantly.. (current dir) and absolute/relative paths.The CLI companion is currently available on macOS only. Windows support is planned for a future release.
No. The CLI command is a standalone script installed in /usr/local/bin/ and is not affected by app updates.
Not yet — the current CLI only supports opening repositories. Integration as a difftool/mergetool is on the roadmap.
Gitoryx will attempt to open the directory and display an error if it doesn't contain a valid Git repository.
Everything in this tutorial is faster and clearer with a visual Git client. Gitoryx is free, runs natively on macOS and Windows, and built for developers who want to move fast without breaking things.