EN | 中文
Commas is a hackable, pluggable terminal, and also a command runner. The name comes from Command Master.
Dark | Light |
---|---|
Theme: OneHalf
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.
You can clone or download the repository and build Commas locally.
- Make sure you have the latest LTS version of Node.js installed on your device.
- Download the source code and enter the directory through the command line.
- Run
pnpm install
to install dependencies - Run
pnpm run build
to build this application for the current platform
- Multi-tab support with customizable layout
- Duplicate or split from current terminal
- Theme system compatible with Windows Terminal
- Plug-in i18n support
- Built-in addons
- Run commands instantly on local or remote server
- Interact with the application in the terminal
- Access the local file system, edit files, and open web pages in the application
- Visual settings editor
- Command completion or fix based on AI
- Take screenshots, record, or share terminal sessions via LAN
- Integration with whistle proxy
- Gist-based configuration synchronization
- Other easter egg features
- User scripts and third-party addons
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.
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.
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.
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.
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.
The best part is that you can use the shortcut key ⌘ ⇧ I to open developer tool of Commas and inspect the HTML elements in the UI just like you would in a browser!
ISC © CyanSalt