hermes - ✅(Solved) Fix [Feature]: add yaml schema for yaml-language-server [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#17266Fetched 2026-04-30 06:48:45
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Participants
Timeline (top)
labeled ×3cross-referenced ×1

Fix Action

Fixed

PR fix notes

PR #17278: feat: add config schema for YAML autocomplete

Description (problem / solution / changelog)

Adds a generated JSON Schema for ~/.hermes/config.yaml and documents how to use it with yaml-language-server.

What changed:

  • add scripts/generate_config_schema.py to build the schema from DEFAULT_CONFIG
  • add website/static/schemas/hermes-config.schema.json
  • add a regression test for schema generation
  • document YAML schema autocomplete in the configuration docs

Closes #17266

Changed files

  • scripts/generate_config_schema.py (added, +261/-0)
  • tests/hermes_cli/test_generate_config_schema.py (added, +27/-0)
  • website/docs/user-guide/configuration.md (modified, +20/-0)
  • website/static/schemas/hermes-config.schema.json (added, +1631/-0)
RAW_BUFFERClick to expand / collapse

Problem or Use Case

currently, modify the config.yaml is really,really pain into the ass!

EVEN WORSE, there is no template for lsp! In json, we have "$scheme":"<template url>" to give us a guide about how to fill correct value to config file, vise versa, in yaml, yaml-language-server also support 'yaml-language-server: $schema=' entry to define scheme of config file So please add a template so we can make out life much easier

Proposed Solution

add a template file, config.template.yaml, and enable it in config.yaml by yaml-language-server: $schema=<path to template file>

Alternatives Considered

No response

Feature Type

Configuration option

Scope

Small (single file, < 50 lines)

Contribution

  • I'd like to implement this myself and submit a PR

Debug Report (optional)

extent analysis

TL;DR

Add a config.template.yaml file and reference it in config.yaml using the yaml-language-server: $schema directive to provide a template for configuration.

Guidance

  • Create a config.template.yaml file with the desired template structure to serve as a guide for users.
  • Update config.yaml to include the yaml-language-server: $schema entry, pointing to the location of the config.template.yaml file.
  • Verify that the template is correctly applied by checking that the config.yaml file is validated against the schema defined in config.template.yaml.
  • Consider adding documentation or comments to explain the purpose and usage of the template file.

Example

# config.yaml
yaml-language-server: $schema=config.template.yaml

Notes

This solution assumes that the yaml-language-server supports the $schema directive and can correctly interpret the template file.

Recommendation

Apply workaround by adding a config.template.yaml file and updating config.yaml to reference it, as this provides a clear and straightforward solution to the problem of lacking a template for configuration.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING