ALACRITTY(1)

📦 version 0.15.1, in ubuntu questing

✨ ALACRITTY(1) — General Commands Manual ✨

💖 NAME

Okay so bestie, Alacritty is a fast, cross-platform, OpenGL terminal emulator 🔥 It's literally giving speed and it works everywhere, no cap 💅

🌸 SYNOPSIS

Alacritty is a modern terminal emulator that comes with sensible defaults 🎀 but it's also super customizable, like seriously extensive ✨ Instead of reinventing what other apps already do, it plugs into them, so you get a flexible set of features with high performance 🦋 iconic behavior tbh 💜

🧚 FLAGS

  • -h, --help — Prints help information 🫶
  • --hold — Remain open after the child process exits 🙈
  • --daemon — Do not spawn an initial window 💀
  • --print-events — Print all events to STDOUT 📣
  • -q — Reduces the level of verbosity (the min level is -qq) 🌈
  • --ref-test — Generates ref test 🧪
  • -v — Increases the level of verbosity (the max level is -vvv) 🔥
  • -V, --version — Prints version information ⭐

🎀 OPTIONS

  • --class <GENERAL> | <GENERAL>,<INSTANCE> — Defines the window class hint on Linux 🌸

Only the general class? Then instance gets set to the same value, periodt 💅

On Wayland the general class sets the app_id, while the instance class is ignored 🦋

Default: Alacritty,Alacritty ✨

  • -e, --command <COMMAND>... — Command and args to execute (must be last argument) 🏃‍♀️
  • --config-file <CONFIG_FILE> — Specify alternative configuration file 📂

Alacritty won't create the config file for you 🙅‍♀️ but it looks for one in these spots on UNIX systems:

  1. $XDG_CONFIG_HOME/alacritty/alacritty.toml
  2. $XDG_CONFIG_HOME/alacritty.toml
  3. $HOME/.config/alacritty/alacritty.toml
  4. $HOME/.alacritty.toml

On Windows, the config file gets looked for in:

  1. %APPDATA%\alacritty\alacritty.toml
  • --embed <PARENT> — X11 window ID to embed Alacritty within (decimal or hexadecimal with 0x prefix) 🪟
  • -o, --option <OPTION>... — Override configuration file options 🎛️

Example:

alacritty -o 'cursor.style="Beam"'
  • --socket <SOCKET> — Path for IPC socket creation 🔌
  • -T, --title <TITLE> — Defines the window title 🏷️

Default: Alacritty 💖

  • --working-directory <WORKING_DIRECTORY> — Start the shell in the specified working directory 📁

🦋 SUBCOMMANDS

  • msg — Send IPC socket messages (see alacritty-msg(1)) 💌
  • migrate — Migrate the configuration file 🚚
    • -c, --config-file <CONFIG_FILE> — Path to the configuration file 📂
    • -d, --dry-run — Only output TOML config to STDOUT 👀
    • -i, --skip-imports — Do not recurse over imports 🙅‍♀️
    • --skip-renames — Do not move renamed fields to their new location 🫠
    • -s, --silent — Do not output to STDOUT 🤫
    • -h, --help — Print help information 🆘

🔗 SEE ALSO

alacritty-msg(1), alacritty(5), alacritty-bindings(5) 💜

🐛 BUGS

Found a bug? Bestie, please report it at https://github.com/alacritty/alacritty/issues 🙏

👑 MAINTAINERS

  • Christian Duerr <contact@christianduerr.com> 💖
  • Kirill Chibisov <contact@kchibisov.com> 💖

Alacritty(1) · 2025-04-28 · ALACRITTY(1) 🌈 Stay fast, stay iconic, and I'll see you in the terminal bestie 💅✨

📦 where this page comes from