Command-line interface
Use AppCode features from the command line: open files and projects, view diffs, merge files, apply code style, formatting, and inspect the source code.
Launcher for a standalone instance
To run AppCode 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 AppCode.app with the following command:
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/appcode with the following contents:
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 appcode
from anywhere in the shell.
Shell scripts generated by the Toolbox App
If you are using the Toolbox App to install and manage JetBrains products, you can use shell scripts for launching your IDEs from the command line.
Toolbox App generates shell scripts automatically and places them to the following folders:
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 AppCode from any working directory.
Change shell scripts location
Open the Toolbox App and click the Toolbox App menu icon in the top right corner.
On the Settings tab, expand the Tools section, and specify another folder in the Shell scrips location field.
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.
Open the Toolbox App.
Click next to an IDE instance and select Settings.
At the bottom, change the Shell script name field.
or
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 AppCode from any working directory.
Change shell scripts location
Open the Toolbox App and click the Toolbox App menu icon in the top right corner.
On the Settings tab, expand the Tools section, and specify another folder in the Shell scrips location field.
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.
Open the Toolbox App.
Click next to an IDE instance and select Settings.
At the bottom, change the Shell script name field.
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 AppCode from any working directory.
Change shell scripts location
Open the Toolbox App and click the Toolbox App menu icon in the top right corner.
On the Settings tab, expand the Tools section, and specify another folder in the Shell scrips location field.
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.
Open the Toolbox App.
Click next to an IDE instance and select Settings.
At the bottom, change the Shell script name field.
Command-line arguments
The launcher script accepts commands, options, and other arguments to modify its behavior:
Argument | Description |
---|---|
No argument | Launch AppCode. |
Path to file or directory | Open the file or directory specified as the argument. For more information, see Open files from the command line. |
Commands | |
| Open the diff viewer to see differences between two specified files. For more information, see Compare files from the command line. |
| Open the Merge dialog to merge the specified files. For more information, see Merge files from the command line. |
| Apply code style formatting to the specified files. For more information, seeFormat files from the command line. |
Options | |
| Do not show the splash screen when loading AppCode. |
| Do not reopen projects and show the welcome screen. This can help if a project that was open crashes AppCode. |
| Do not load manually installed plugins. This can help if a plugin that you installed crashes AppCode. You will be able to start the IDE and either disable or uninstall the problematic plugin. |
| Wait for the files to be closed before returning to the command prompt. For example, you can open file.txt with the following command: The shell will be waiting until file.txt is closed. |