You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
When trying to override the default agents with custom configurations, not all configs and metadata are applied and propagated in the TUI.
Nothing is majorly blocking, but it seems like the preamble of the .md files aren't fully applied.
The prompt itself is applied as expected and a workaround is to simply give another name to the file.
Workaround for now is to rename an agent file to not collide with the built-in.
OpenCode version
1.0.20
Steps to reproduce
Create an agent with the same name as a built-in agent, e.g., plan.md
Add in a preamble, such as the blow (not the mode: all and description:
<!-- agent/plan.md -->---
description: Strategic analysis and development planning specialist. Provides comprehensive analysis and actionable implementation roadmaps without making code changes.
model: opencode/qwen3-coder
mode: all
tools:
read: true
grep: true
glob: true
list: true
todoread: true
webfetch: true
context7: true
write: false
edit: false
bash: false
patch: false
todowrite: false
---<!-- Agent prompt -->
Start up OpenCode in a new session
Try to ping plan as a subagent
Notice that it won't show up
Open up the agent picker and see that the description for the agent is still native
Activity
github-actions commentedon Nov 4, 2025
This issue might be a duplicate of existing issues. Please check:
Feel free to ignore if none of these address your specific case.
rekram1-node commentedon Nov 4, 2025
Yeah there is prolly some logic in agent.ts or in the tui that is preventing it from showing up....
edit: seems to be in agent.ts