Skip to content

[FEATURE]: Config dir AGENTS.md conflates global and repo-specific rules #11639

Closed

Description

@MichaelYochpaz

Feature hasn't been suggested before.

  • I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

I version my ~/.config/opencode/ as a git repo (skills, commands, etc) for version-control and easy syncing across computers.

When I want to add an AGENTS.md there, it ends up serving two purposes that don't mix well:

  1. Global preferences - rules I want applied to all my OpenCode sessions everywhere
  2. Repo development context - instructions for working on this config repo specifically (like "check OpenCode docs when writing skills")

(docs for reference)

The problem is everything in ~/.config/opencode/AGENTS.md gets loaded globally, so any instructions I give agents that work on my OpenCode configuration repo (for creating skills, updating OpenCode configuration, etc.) also supposedly shows up for any project I'm working on with OpenCode.

Suggestion

A convention to use a different file for "repo-specific" stuff when the config dir is itself a repo.
For example, for the actual OpenCode config repo, the regular AGENTS.md will be used, while the global preferences file will have a different name, like USER-AGENTS.md / AGENTS.user.md GLOBAL-AGENTS.md / AGENTS.global.md, or something along these lines.

Activity

  1. added
    discussionUsed for feature requests, proposals, ideas, etc. Open discussion
    on Feb 1, 2026
  2. github-actions commented on Feb 1, 2026

    @github-actions
    Contributor

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

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

  3. github-actions commented on Apr 3, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

discussionUsed for feature requests, proposals, ideas, etc. Open discussiondocs

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions