anomalyco/opencode
1
0
Fork 0
mirror of https://github.com/anomalyco/opencode.git synced 2026-07-23 02:36:57 -04:00
Code Issues 5.9k Packages Projects Releases 19 Wiki Activity

AGENT.md vs AGENTS.md #1354

New Issue
Closed
opened 2026-02-16 17:30:34 -05:00 by yindo · 8 comments
yindo commented 2026-02-16 17:30:34 -05:00
Owner
Copy Link
Copy Source

Originally created by @davidhopkins on GitHub (Aug 18, 2025).

Originally assigned to: @thdxr on GitHub.

I had started putting AGENT.md file in several codebases but the default behaviour of this tool appears to prefer AGENTS (plural) i.e.

I'll analyze the codebase to understand the structure, build system, and coding conventions, then create an AGENTS.md file for coding agents.
Build claude-sonnet-4 (01:31 PM)

The creators of the AGENT.md initiative seem pretty flexible but haven't gotten very far with the AGENTS.md issue.

Could this tool perhaps support both plural and singular until it gets resolved?

Originally created by @davidhopkins on GitHub (Aug 18, 2025). Originally assigned to: @thdxr on GitHub. I had started putting `AGENT.md` file in several codebases but the default behaviour of this tool appears to prefer AGENTS (plural) i.e. ``` I'll analyze the codebase to understand the structure, build system, and coding conventions, then create an AGENTS.md file for coding agents. Build claude-sonnet-4 (01:31 PM) ``` The creators of the [AGENT.md initiative](https://ampcode.com/AGENT.md) seem pretty flexible but haven't gotten [very far](https://x.com/sqs/status/1923794823238254629) with the AGENTS.md issue. Could this tool perhaps support both plural and singular until it gets resolved?
yindo closed this issue 2026-02-16 17:30:34 -05:00
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@rekram1-node commented on GitHub (Aug 18, 2025):

for the time being you can add "instructions": ["AGENT.md"] to your global opencode configuration and opencode will always pick it up for you

@rekram1-node commented on GitHub (Aug 18, 2025): for the time being you can add "instructions": ["AGENT.md"] to your global opencode configuration and opencode will always pick it up for you
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@rekram1-node commented on GitHub (Aug 18, 2025):

Currently codex & gemini cli both support AGENTS.md but last I checked neither supports AGENT.md

@rekram1-node commented on GitHub (Aug 18, 2025): Currently codex & gemini cli both support AGENTS.md but last I checked neither supports AGENT.md
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@davidhopkins commented on GitHub (Aug 18, 2025):

Currently codex & gemini cli both support AGENTS.md but last I checked neither supports AGENT.md

Yes it's annoying because AGENTS seems to be gathering support in the field whereas AGENT seems to be the more "correct" one. Am in the process of making a change to some tooling that will add one of these files to over a hundred separate repos so I'd really like to pick the right one.

@davidhopkins commented on GitHub (Aug 18, 2025): > Currently codex & gemini cli both support AGENTS.md but last I checked neither supports AGENT.md Yes it's annoying because AGENTS seems to be gathering support in the field whereas AGENT seems to be the more "correct" one. Am in the process of making a change to some tooling that will add one of these files to over a hundred separate repos so I'd really like to pick the right one.
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@rekram1-node commented on GitHub (Aug 18, 2025):

I think you will be better off using plural agents just because it seems to be more widely adopted

@rekram1-node commented on GitHub (Aug 18, 2025): I think you will be better off using plural agents just because it seems to be more widely adopted
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@thdxr commented on GitHub (Aug 18, 2025):

we'll likely keep getting asked to support more out of the box - we don't want to do that because we need to guide people on our "official" one

we picked AGENTS.md because of codex and now gemini also supports it. ultimately i don't even know if a standard makes sense because every tool works differently and supports different patterns inside this file

hopefully the instructions field will make everyone happy

@thdxr commented on GitHub (Aug 18, 2025): we'll likely keep getting asked to support more out of the box - we don't want to do that because we need to guide people on our "official" one we picked `AGENTS.md` because of codex and now gemini also supports it. ultimately i don't even know if a standard makes sense because every tool works differently and supports different patterns inside this file hopefully the `instructions` field will make everyone happy
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@pythoninthegrass commented on GitHub (Aug 18, 2025):

for the time being you can add “instructions”: [“AGENT.md”] to your global opencode configuration and opencode will always pick it up for you

This seems to work after fixing the non-monospace double quotes (probably smart quotes on mobile/email):

// ~/.config/opencode/agent/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "instructions": ["AGENT.md"]
}
@pythoninthegrass commented on GitHub (Aug 18, 2025): > for the time being you can add “instructions”: [“AGENT.md”] to your global opencode configuration and opencode will always pick it up for you This seems to work after fixing the non-monospace double quotes (probably smart quotes on mobile/email): ```json5 // ~/.config/opencode/agent/opencode.json { "$schema": "https://opencode.ai/config.json", "instructions": ["AGENT.md"] } ```
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@rekram1-node commented on GitHub (Aug 18, 2025):

thank you @pythoninthegrass I typed that on my phone originally, just editing comment

@rekram1-node commented on GitHub (Aug 18, 2025): thank you @pythoninthegrass I typed that on my phone originally, just editing comment
yindo commented 2026-02-16 17:30:35 -05:00
Author
Owner
Copy Link
Copy Source

@jamesforwardnwboxed commented on GitHub (Aug 26, 2025):

This link has now become https://agents.md/ so I think the adoption of AGENTS.md has outweighted AGENT.md and has basically become the standard

@jamesforwardnwboxed commented on GitHub (Aug 26, 2025): This link has now become https://agents.md/ so I think the adoption of `AGENTS.md` has outweighted `AGENT.md` and has basically become the standard
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
acp
bad
bug
discussion
docs
documentation
enhancement
extension
good first issue
growth
help-wanted
mcp
model-problem
needs:compliance
nix
opentui
perf
pull-request
Mirrored from GitHub Pull Request
 tui
web
windows
zen
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#1354
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?