Syntax highlighting, IntelliSense, validation, and documentation for kitty.conf configuration
Kitty is a fast, feature-rich, GPU-based terminal emulator. This extension brings first-class editing support for kitty.conf configuration files directly into VS Code, with dedicated syntax highlighting, completions, hover docs, and validation.
Dedicated TextMate grammar built specifically for kitty.conf. Unlike generic config highlighters, this grammar understands kitty's unique syntax: comments, directives (map, mouse_map, include, globinclude, env), key-value options, hex colors, booleans, numbers, and action names.
Full autocompletion for all 100+ kitty options with context-aware suggestions.
- Option names with descriptions, types, and defaults
- Enum values for options like
cursor_shape,tab_bar_style,placement_strategy - Color names for color options with hex validation
- Action names for
mapandmouse_mapdirectives
Hover over any option name to see its description, type, default value, accepted values for enums, and a direct link to the kitty documentation.
Real-time validation catches configuration errors as you type:
- Unknown option names with "did you mean?" suggestions
- Invalid enum values with the list of accepted values
- Invalid hex color codes
- Type mismatches (string where number expected, etc.)
Quick-start templates for common configurations:
| Prefix | Description |
|---|---|
kitty-starter |
Basic kitty.conf starter template |
kitty-fonts |
Font configuration block |
kitty-colors |
Color scheme configuration |
kitty-keybinds |
Common keybinding configuration |
kitty-tabs |
Tab bar configuration |
kitty-window |
Window layout configuration |
All major kitty configuration categories are covered:
Fonts Cursor Scrollback Mouse Performance Terminal Bell Window Layout Tab Bar Colors Advanced
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X/Cmd+Shift+X) - Search for Kitty Toolkit
- Click Install
Or install from the command line:
code --install-extension atoolz.kitty-vscode-toolkit- VS Code 1.85.0 or higher
No additional extensions needed. Kitty Toolkit includes its own TextMate grammar for kitty.conf syntax highlighting.
The extension activates automatically when you open a file named kitty.conf.
Contributions are welcome. Please open an issue or pull request on GitHub.