Command-line interface

The installation directory contains batch scripts and executables for launching GoLand, formatting the source code, and running inspections. To use them from the Command Prompt cmd.exe, add the location of the GoLand bin folder to the PATH environment variable. For example, if you installed GoLand to C:\Program Files\JetBrains\GoLand, you can use the following command:

>
set PATH=%PATH%;C:\Program Files\JetBrains\GoLand\bin

This command changes the PATH environment variable for the current shell only (the current instance of cmd.exe). If you want to update it permanently for the current user, run setx:

>
setx PATH "%PATH%;C:\Program Files\JetBrains\GoLand\bin"

To update it system-wide for all users, run setx /M instead of setx.

tip

The installer can do this for you if you select Add launchers dir to the PATH on the Installation Options step of the setup wizard.

After you configure the PATH variable, you can run the executable from any working directory in the Command Prompt: goland64.exe. Alternatively, you can use the batch script: goland.bat.

To run GoLand from the shell, use the open command with the following options:

• -a: specify the application.

• --args: specify additional arguments when passing more than just the file or directory to open.

• -n: open a new instance of the application even if one is already running.

For example, you can run GoLand.app with the following command:

$
open -na "GoLand.app"

note

If GoLand is not in the default /Applications directory, specify the full path to it.

You can create a shell script with this command in a directory from your PATH environment variable. For example, create the file /usr/local/bin/goland with the following contents:

#!/bin/sh

open -na "GoLand.app" --args "$@"

Make sure you have permissions to execute the script and since /usr/local/bin should be in the PATH environment variable by default, you should be able to run goland from anywhere in the shell.

On Linux, the installation directory contains the launcher shell script goland.sh under bin. For example, if you installed GoLand to /opt/goland, you can run the script using the following command:

$
/opt/goland/bin/goland.sh

You can create a symbolic link to the launcher script in a directory from the PATH environment variable. For example, if you installed GoLand to /opt/goland and want to create a link named goland in /usr/local/bin, run the following command:

$
ln -s /opt/goland/bin/goland.sh /usr/local/bin/goland

Since /usr/local/bin should be in the PATH environment variable by default, you should be able to run the goland command from anywhere in the shell.

%LOCALAPPDATA%\JetBrains\Toolbox\scripts

By default, the Toolbox App puts shell scripts in a directory from the system PATH environment variable, so you can run the name of the script as a command to launch GoLand from any working directory.

Rename shell scripts

If you have several versions of the same IDE, the Toolbox App generates a shell script for each version with a unique name. You can change the name of the shell script for an IDE instance in the settings for this specific instance.

1. Open the Toolbox App.

2. Click next to an IDE instance and select Settings.

3. At the bottom of the Configuration section, change the Shell script name field.

/usr/local/bin

or

~/Library/Application Support/JetBrains/Toolbox/scripts

By default, the Toolbox App puts shell scripts in a directory from the system PATH environment variable, so you can run the name of the script as a command to launch GoLand from any working directory.

Rename shell scripts

If you have several versions of the same IDE, the Toolbox App generates a shell script for each version with a unique name. You can change the name of the shell script for an IDE instance in the settings for this specific instance.

1. Open the Toolbox App.

2. Click next to an IDE instance and select Settings.

3. At the bottom of the Configuration section, change the Shell script name field.

~/.local/share/JetBrains/Toolbox/scripts

By default, the Toolbox App puts shell scripts in a directory from the system PATH environment variable, so you can run the name of the script as a command to launch GoLand from any working directory.

Rename shell scripts

If you have several versions of the same IDE, the Toolbox App generates a shell script for each version with a unique name. You can change the name of the shell script for an IDE instance in the settings for this specific instance.

1. Open the Toolbox App.

2. Click next to an IDE instance and select Settings.

3. At the bottom of the Configuration section, change the Shell script name field.