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": {
"lsp": ["uvx ruff server", "uvx ty server"]
}
},
{
"name": "Prettier",
"document": ["javascript", "typescript"],
"condition": {
"when": "grep \"\\\"prettier\\\":\" package.json"
},
"action": {
"formatter": "npx prettier --stdin-filepath ${filePath}"
}
},
{
"name": "VitePlus",
"document": ["javascript", "typescript"],
"condition": {
"when": "grep \"\\\"vite-plus\\\":\" package.json"
},
"action": {
"lsp": ["vp lint --lsp", "vp fmt --lsp"]
}
},
{
"name": "Oxc",
"document": ["javascript", "typescript"],
"condition": {
"whenNot": [
"grep \"\\\"prettier\\\":\" package.json",
"grep \"\\\"vite-plus\\\":\" package.json"
]
},
"action": {
"lsp": ["npx oxlint --lsp", "npx oxfmt --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).
