A unified VSCode extension for configuring custom language settings, formatters, and Language Server Protocol (LSP) servers through a single rule-based configuration system.
Features
- Register custom formatters for any language
- Multiple formatters can be applied sequentially to the same document
- Conditional formatting based on shell command execution results
Custom LSPs
- Multiple language server management
- Dynamic server registration based on workspace conditions
Rule-Based Configuration
- Flexible rule system with document selectors
- Conditional activation based on shell commands
- Support for multiple commands per action
Configuration
The extension uses a rule-based configuration system. Add rules to your settings.json:
Example
Before using this example, uninstall conflicting extensions and install the ESLint language server:
code --uninstall-extension charliermarsh.ruff
code --uninstall-extension oxc.oxc-vscode
code --uninstall-extension biomejs.biome
npm i -g vscode-langservers-extracted
{
"customLanguageTools.rules": [
{
"name": "Python",
"document": ["python"],
"action": {
"formatter": "uvx ruff check - --fix --unfixable F401",
"lsp": ["uvx ruff server", "uvx ty server"]
}
},
{
"name": "Biome",
"document": ["javascript", "typescript"],
"condition": {
"when": "grep \"\\\"@biomejs/biome\\\":\" package.json"
},
"action": {
"formatter": "npx @biomejs/biome format --stdin-file-path=${filePath}",
"lsp": "npx @biomejs/biome lsp-proxy"
}
},
{
"name": "VitePlus",
"document": ["javascript", "typescript"],
"condition": {
"when": "grep \"\\\"vite-plus\\\":\" package.json"
},
"action": {
"formatter": "vp fmt --stdin-filepath=${filePath}",
"lsp": "vp lint --lsp"
}
},
{
"name": "Oxc",
"document": ["javascript", "typescript"],
"condition": {
"whenNot": [
"grep \"\\\"@biomejs/biome\\\":\" package.json",
"grep \"\\\"vite-plus\\\":\" package.json"
]
},
"action": {
"formatter": "npx oxfmt --stdin-filepath=${filePath}",
"lsp": "npx oxlint --lsp"
}
}
]
}
Configuration Options
name (required)
Name for this rule.
document (required)
Array of target language IDs or DocumentFilter objects. Use "*" to match all languages.
condition (optional)
Conditions for applying this rule.
when (optional): Shell command(s) that must return exit code 0 to enable the rule (e.g., "npm ls biome")whenNot (optional): Shell command(s) that must return exit code 0 to disable the rule (e.g., "grep vite-plus package.json")
action (required)
Actions applied when the rule is active.
formatter (optional): Formatter command(s). Supports ${filePath} variable substitution (e.g., "npx prettier --stdin-filepath ${filePath}")lsp (optional): LSP server command(s) (e.g., "npx biome lsp-proxy")
Commands
Restart All Language Services
Command ID: customLanguageTools.restartAll
Restarts all language services (formatters, LSP servers).
https://github.com/JKillian/vscode-custom-local-formatters
https://github.com/pepebecker/vscode-lsp-config
https://github.com/ArturoDent/custom-language-properties
