Format files from the command line

AppCode can format your code according to the configured code style settings. You can also apply your code style formatting to the specified files from the command line.

The command-line formatter launches an instance of AppCode in the background and applies the formatting. It will not work if another instance of AppCode is already running. In this case, you can perform code style formatting from the running instance. Use the command-line formatter for automated regular maintenance of a large codebase with many contributors to ensure a consistent coding style.

To be able to format files, install and enable plugins with support for the corresponding file types in AppCode (for example, the Shell Script plugin to format shell script files).

AppCode includes a script for running the command-line code formatter. By default, it is located in the application package: AppCode.app/Contents/bin/format.sh

Syntax

format.sh [<options>] <path ...>

Examples

Format two specific files from the ~/Data/src directory using the default code style settings:

format.sh ~/Data/src/hello.html ~/Data/src/world.html

Recursively format all files in the ~/Data/src directory including all subdirectories using the default code style settings:

format.sh -r ~/Data/src

Non-recursively format all the .xml and .html files in the ~/Data/src directory using code style settings from ~/Data/settings.xml:

format.sh -s ~/Data/settings.xml -m *.xml,*.html ~/Data/src