Built-in agent overrides don't fully apply #2580

Open
opened 2026-02-16 17:36:19 -05:00 by yindo · 2 comments
Owner

Originally created by @felixnorden on GitHub (Nov 4, 2025).

Originally assigned to: @rekram1-node on GitHub.

Description

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

  1. Create an agent with the same name as a built-in agent, e.g., plan.md
  2. 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 -->
  1. Start up OpenCode in a new session
  2. Try to ping plan as a subagent
  • Notice that it won't show up
  1. Open up the agent picker and see that the description for the agent is still native

Screenshot and/or share link

plan.md file
Image

Subagent ping for @plan
Image

Agent picker showing "native" description
Image

Operating System

macOS Sequoia 15.6.1

Terminal

Ghostty

Originally created by @felixnorden on GitHub (Nov 4, 2025). Originally assigned to: @rekram1-node on GitHub. ### Description 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 1. Create an agent with the same name as a built-in agent, e.g., `plan.md` 2. Add in a preamble, such as the blow (not the `mode: all` and `description`: ```md <!-- 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 --> ``` 3. Start up OpenCode in a new session 4. Try to ping `plan` as a subagent - Notice that it won't show up 5. Open up the agent picker and see that the `description` for the agent is still `native` ### Screenshot and/or share link `plan.md` file <img width="1648" height="280" alt="Image" src="https://github.com/user-attachments/assets/0d1f21a2-c928-422a-9039-c0d9e9f9ddaa" /> Subagent ping for `@plan` <img width="892" height="280" alt="Image" src="https://github.com/user-attachments/assets/0354d8de-9715-4732-9831-37ea06b743e1" /> Agent picker showing "native" description <img width="892" height="565" alt="Image" src="https://github.com/user-attachments/assets/91be8d25-0c79-4637-8e3a-8a21eb6dbd01" /> ### Operating System macOS Sequoia 15.6.1 ### Terminal Ghostty
yindo added the bug label 2026-02-16 17:36:19 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Nov 4, 2025):

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

  • #3575: Reports the exact same problem where overriding built-in agents applies custom prompts but ignores other configurations like permissions, metadata, and settings.

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

@github-actions[bot] commented on GitHub (Nov 4, 2025): This issue might be a duplicate of existing issues. Please check: - #3575: Reports the exact same problem where overriding built-in agents applies custom prompts but ignores other configurations like permissions, metadata, and settings. Feel free to ignore if none of these address your specific case.
Author
Owner

@rekram1-node commented on GitHub (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

@rekram1-node commented on GitHub (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
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#2580