Home

Awesome

Commas

<img src="https://raw.githubusercontent.com/CyanSalt/commas/master/resources/images/icon.png" width="96">

EN | 中文

Commas is a hackable, pluggable terminal, and also a command runner. The name comes from Command Master.

DarkLight
ScreenshotScreenshot

Theme: OneHalf

Installation

Prebuilt version

Download the latest version

It can also be installed via Homebrew (especially on macOS)

brew install --cask cyansalt/cask/commas

[!WARNING] The prebuilt version of Windows or Linux don't work currently, see #20. It is recommended to build manually.

Build manually

You can clone or download the repository and build Commas locally.

Features

Customization

All of user data are stored in a separate user data folder, which is ~/Library/Application Support/Commas/ on macOS, %localappdata%/Commas/ on Windows and ~/.config/Commas/ on Linux. These files can be shared between different devices. The configuration files (settings, key bindings, translations) are in YAML format, while the resource files (themes) are in JSON format.

Configuration

You can configure the application's interface and functionality at a granular level via settings.yaml. For example, to enable font ligatures in the terminal:

terminal.style.fontLigatures: true

Additionally, the built-in settings addon supports managing these configurations in graphical forms.

Theme

Commas supports windowsterminal-compatible theme files. You can place theme files in the themes directory of the user data folder, and then specify the theme name through the settings.

Commas will display a dark / light theme that follows your system's dark mode by default. You can specify the theme in dark / light mode separately, or you can change this behavior to keep the theme unchanged.

The built-in theme addon supports downloading themes from windowsterminalthemes.dev. There are currently 300+ available themes that can be downloaded and used.

I18n

Commas currently has built-in supports for English and Simplified Chinese. You can also enable translation for other languages by adding / modifying the translation.yaml file under the user data folder. The content of the file can be something like part of the translation file.

You can also reference an existing translation file in the form of @use: zh-CN if you are using a dialect of one of the built-in languages.

Addons and user scripts

Commas has several useful / interesting built-in addons. In addition, you can also download / write third-party addons to be placed in the addons directory of the user data folder, and manage which addons you want to enable via settings.

With the built-in addon-manager addon, all built-in and self-added addons can be easily managed via a graphical interface.

Add-ons are based on a rich set of hook APIs. You can read the built-in addons for reference in writing your own addons. For some simple scenarios, you can add / modify the custom.js and custom.css files directly under the user data folder to implement custom logic and styles. custom.js also has full hook API support.

Developer tools

The best part is that you can use the shortcut key <kbd></kbd> <kbd></kbd> <kbd>I</kbd> to open developer tool of Commas and inspect the HTML elements in the UI just like you would in a browser!

License

ISC © CyanSalt