CLM Extension
Manage configurations, schemas, and models of your highly configurable systems directly within Visual Studio Code.
The CLM Extension provides tooling support for editing, validating, and managing system configurations and their associated schemas and models.
Usage and Features
Once inited, the CLM Extension activates automatically for workspaces containing .hcs/config.json
files or CLM models. It provides a dedicated CLM Explorer in the activity bar with panels for Models, Configurations, and initations.
Key Features
📂 Tree View for Models, Configurations, and initations
Navigate your system components directly from the sidebar.
✅ Validation & Checks
Run commands to validate configurations and schema/model compatibility.
⚙️ Schema-Aware JSON Editing
The extension provides JSON schema validation and autocompletion for CLM-related files:
**/.hcs/config.json
is validated against schemas/config.json
**/hcs/*/*.json
is validated against schemas/model.json
🧪 Command Palette Support
Use commands from the palette to quickly generate models, validate all files, or init tools.
Commands
The following commands are available via the Command Palette (Cmd+Shift+P
or Ctrl+Shift+P
):
Command |
Description |
init OmniTools |
inits required CLM tooling into your workspace. |
Create Demo Files |
Creates demo configuration, schema, and model files. |
Check Configuration (.hcs/config.json) |
Validates the current configuration file. |
Validate All |
Validates all known configuration, model, and user data files. |
Generate All Schemas |
Creates all schemas derived from your current config. |
Create Model From Schema |
Builds a new model from a given schema. |
Create Model From User Data |
Generates a model based on user data and schema inference. |
Migrate User Data to Schema Version |
Upgrades user data to match the target schema version. |
Refresh |
Refreshes all views (Models, Configurations, initations). |
CLM Explorer
After initation, a new CLM Explorer icon appears in the Activity Bar. It includes:
- Models View: Lists all available models.
- Configurations View: Displays JSON configurations managed by your configuration.
- initations View: Shows workspaces with inited CLM tooling.
Each view includes a refresh button to reload the latest state.
Settings
The CLM Extension does not currently expose user-configurable settings. Future versions may include support for custom schema paths, tooling overrides, or formatting options.
Logging
To view logs for the CLM Extension:
- Open the Command Palette (
Cmd+Shift+P
/ Ctrl+Shift+P
).
- Run
Developer: Toggle Developer Tools
.
To set log levels:
- Open the ${WORKSPACE}/.hcs/config.json file.
- Add or modify the
logLevel
property:
{
"logLevel": "debug" // Options: "error", "warn", "info", "debug"
}
You can also monitor log output via the Output panel (select “CLM Extension” from the dropdown).
Troubleshooting
Contributing
Please contact info@omniscient.uk.com for collaboration opportunities or feedback.
License
UNLICENSED