You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
ConfigInvalidError on Windows due to unrecognized keys in opencode.json #7483
ConfigInvalidError
Config file at C:\Users\Usuario\opencode.json is invalid
↳ Unrecognized keys: "name", "description", "rules", "context", "notes"
When attempting to run the OpenCode tool on Windows, the configuration file located at C:\Users\Usuario\opencode.json fails to load with a ConfigInvalidError. The error indicates that the following keys in the configuration file are not recognized:
name
description
rules
context
notes
Request:
Clarify the valid configuration schema for OpenCode.
Update documentation or error messages to list accepted keys.
Consider backward compatibility for deprecated keys.
Environment:
OS: Windows
Config Path: C:\Users\Usuario\opencode.json
ConfigInvalidError: Config file at C:\Users\Usuario\opencode.json is invalid
↳ Unrecognized keys: "name", "description", "rules", "context", "notes"
Expected Behavior:
The tool should either:
Ignore unrecognized keys (with a warning), or
Clearly document valid configuration keys and schema.
Steps to Reproduce:
Create a config file at C:\Users\Usuario\opencode.json with the above keys.
Run any OpenCode command that reads this config.
The error is thrown, halting execution.
Possible Causes:
The configuration schema may have changed in a recent update.
Windows-based paths or environment might trigger stricter validation.
Request:
Clarify the valid configuration schema for OpenCode.
Update documentation or error messages to list accepted keys.
Consider backward compatibility for deprecated keys.
Screenshot and/or share link
No response
Operating System
OS: Windows
Terminal
Config Path: C:\Users\Usuario\opencode.json
Error:
ConfigInvalidError: Config file at C:\Users\Usuario\opencode.json is invalid
↳ Unrecognized keys: "name", "description", "rules", "context", "notes"
This issue might be a duplicate of existing issues. Please check:
[DISCUSSION] Make config tolerant of unknown keys for forward compatibility #6145: [Discussion] Make config tolerant of unknown keys for forward compatibility - Directly related to the unrecognized keys problem you're experiencing. The discussion explores making the config validator accept unknown keys instead of rejecting them.
You can see the schema with descriptions for the properties here, and you could use and ide/editor with a proper json lsp to validate your config and get suggestions for valid fields according to the config schema.
Activity
github-actions commentedon Jan 9, 2026
This issue might be a duplicate of existing issues. Please check:
Feel free to ignore if none of these address your specific case.
cravenceiling commentedon Jan 9, 2026
You can see the schema with descriptions for the properties here, and you could use and ide/editor with a proper json lsp to validate your config and get suggestions for valid fields according to the config schema.
rekram1-node commentedon Jan 9, 2026
this is expected, seems like your config is invalid, the error message is pretty clear on what you should fix
rekram1-node commentedon Jan 12, 2026
@neurafusionai it seems to me that ur unfamiliar with json schemas? are u just pasting a schema as a config? you dont want to do that