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
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
- 1Open Gitoryx → Settings → About → Install Command
- 2Open your terminal and navigate to a Git repository
- 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
Step 1: Install the CLI command from Gitoryx
Open Gitoryx, go to Settings → About, and click "Install Command". This creates the
gitoryxcommand 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.
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.Terminalcd ~/projects/my-appgitoryx .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-repoStep 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.
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
gitoryxcommand 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
.gitfolder). - 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.
Related reading
- Git Config: How to Configure Git for Your WorkflowTutorial · 8 min
- Git Clone: How to Copy a RepositoryTutorial · 8 min
- Git Log: How to Browse Your Commit HistoryTutorial · 9 min
- When a Git GUI Beats the Terminal: Bisect, Interactive Rebase, and MoreBlog · 12 min
- Why Desktop Git Clients Still Matter in the Age of VS CodeBlog · 8 min