Skip to content

[FEATURE]: Docs: clarify that local and global AGENTS.md are both loaded, not exclusive #33908

Closed as not planned

Description

@piknockyou

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 wanted to know if opencode loads both a project AGENTS.md and my global ~/.config/opencode/AGENTS.md at the same time.

The docs currently say:

When opencode starts, it looks for rule files in this order:

  1. Local files by traversing up from the current directory (AGENTS.md, CLAUDE.md)
  2. Global file at ~/.config/opencode/AGENTS.md
  3. Claude Code file at ~/.claude/CLAUDE.md (unless disabled)

The first matching file wins in each category.

That reads like only one file wins overall.

But earlier the same page says:

"opencode also supports reading the AGENTS.md file from multiple locations."

I'm not sure if local and global are combined, or if having a local file disables the global one.

Request
Please rephrase the Precedence section to make it explicit that:

  • all three layers are loaded and concatenated in order
  • "first wins" only applies within each layer (AGENTS.md beats CLAUDE.md)

Activity

  1. github-actions commented on Jun 25, 2026

    @github-actions
    Contributor

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

  2. github-actions commented on Aug 25, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 60 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

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions