Repository navigation
[FEATURE]:Display warning when agents.md is not accessible #3603
Description
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 have a mono repo and I often start opencode accidentally from a sub directory. Due to sandboxing, the agent does not have access to the agents.md file and therefore is not aware of my preferences or even code that would be relevant to the task at hand.
I would really like opencode to let me know when I'm trying to use an agent that does not have access to my agents.md whether it's due to sandboxing or because initialization has not been done.
If it is actually easy to set the context to the repo root when starting from a subfolder, I have not found it in the documentation.
I'm mainly talking about the UX, I would really want a message/warning light that the agent is flying blind.
There are some other issues that mention similar issues, afaict the most relevant are
#1143
#1877
#2177
Activity
github-actions commentedon Oct 31, 2025
This issue might be a duplicate of existing issues. Please check:
Feel free to ignore if none of these address your specific case.
ori-nonni commentedon Oct 31, 2025
This is very relevant, but for some reason I'm not seeing the behaviour outlined in #2094. If I start inside a subfolder of my monorepo, the agent does NOT have access to my agents.md. (verified by asking the agent). See image.
Also, this is a slightly different issue, as it is asking for UI to warn the user when the agent is flying blind.
rekram1-node commentedon Oct 31, 2025
@ori-nonni the AGENTS.md is automatically included in the system prompt
ori-nonni commentedon Nov 1, 2025
Ah, then it's honestly a non-issue. I ran into this when I wanted the build agent to update my agents file and then I was concerned that the agent didn't know about my preferences etc.
So I think the outstanding issue is maybe a little bit more documentation for noobs about how to work efficiently in a mono repo (agent override or extension in a single project), also maybe give access to a sister project without restarting the tui
rekram1-node commentedon Nov 1, 2025
yeah adding stuff outside current dir is something we need to add