0.11.6 in conflict with config instructions (too restrictive on valid directories inside .config/opencode) #1835

Closed
opened 2026-02-16 17:32:51 -05:00 by yindo · 5 comments
Owner

Originally created by @jflaflamme on GitHub (Sep 26, 2025).

as per https://opencode.ai/docs/rules/

The recommended approach is to use the instructions field in opencode.json:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
}

Since last update:

Error: Config file at /home//.config/opencode is invalid: Unexpected directory "rules" found in "/home//.config/opencode". Only agent, command, mode, plugin, tool directories are allowed.

Originally created by @jflaflamme on GitHub (Sep 26, 2025). as per https://opencode.ai/docs/rules/ ``` The recommended approach is to use the instructions field in opencode.json: opencode.json { "$schema": "https://opencode.ai/config.json", "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"] } ``` Since last update: Error: Config file at /home/<user>/.config/opencode is invalid: Unexpected directory "rules" found in "/home/<user>/.config/opencode". Only agent, command, mode, plugin, tool directories are allowed.
yindo closed this issue 2026-02-16 17:32:51 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Sep 26, 2025):

This issue might be a duplicate of existing issues. Please check:

  • #2793: Exact duplicate with same error pattern but "bin" directory instead of "rules" directory
  • #2768: User reported crashes when adding dependencies under .opencode/tool/ suggesting similar directory validation issues

The core issue appears to be version 0.11.6 introducing overly restrictive directory validation in ~/.config/opencode that breaks existing valid configurations.

Feel free to ignore if none of these address your specific case.

@github-actions[bot] commented on GitHub (Sep 26, 2025): This issue might be a duplicate of existing issues. Please check: - #2793: Exact duplicate with same error pattern but "bin" directory instead of "rules" directory - #2768: User reported crashes when adding dependencies under .opencode/tool/ suggesting similar directory validation issues The core issue appears to be version 0.11.6 introducing overly restrictive directory validation in ~/.config/opencode that breaks existing valid configurations. Feel free to ignore if none of these address your specific case.
Author
Owner

@OpeOginni commented on GitHub (Sep 26, 2025):

@jflaflamme Could you share parts of your config?

@OpeOginni commented on GitHub (Sep 26, 2025): @jflaflamme Could you share parts of your config?
Author
Owner

@vasilvestre commented on GitHub (Sep 26, 2025):

I have a lot of custom folder in my opencode directory and this error just broke my opencode, I can't open it anymore and have to rework the whole infrastructure. No BC and just a restrictive update is harsh.

@vasilvestre commented on GitHub (Sep 26, 2025): I have a lot of custom folder in my opencode directory and this error just broke my opencode, I can't open it anymore and have to rework the whole infrastructure. No BC and just a restrictive update is harsh.
Author
Owner

@arsham commented on GitHub (Sep 26, 2025):

The last release fixes it.

@arsham commented on GitHub (Sep 26, 2025): The last release fixes it.
Author
Owner

@rekram1-node commented on GitHub (Sep 26, 2025):

This should be fixed

@rekram1-node commented on GitHub (Sep 26, 2025): This should be fixed
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#1835