Feature hasn't been suggested before.
Describe the enhancement you want to request
Summary
Add support for a name field inside agent definition files and config so the displayed agent name does not depend on the markdown filename.
Currently, according to the docs:
"The markdown file name becomes the agent name. For example, review.md creates a review agent."
This creates unnecessary coupling between filesystem naming and runtime/UI naming.
Problem
Right now the filename fully determines the agent name. This causes several issues:
- Renaming files unintentionally renames agents.
- It is difficult to maintain consistent naming across environments.
- Repository organization and agent naming cannot be managed independently.
Additionally, OpenCode automatically uppercases the first letter of the derived name, which breaks certain naming conventions.
Example:
- filename:
opencode_auditor.md
- resulting agent name:
Opencode_auditor instead of opencode_auditor
Proposed Solution
Support a dedicated name field in the agent file frontmatter the same way as description is present.
Example:
---
name: opencode_auditor
description: "..."
---
# Agent instructions...
Similar field should also be present in opencode.json config file under agent section.
Expected Behavior
- If
name is present, use it exactly as provided.
- Do not automatically transform capitalization.
- If
name is absent, preserve the current filename-based fallback behavior for backward compatibility.
Benefits
- Decouples filesystem naming from displayed agent naming.
- Enables consistent naming conventions.
- Prevents unwanted automatic capitalization.
- Maintains backward compatibility.
Feature hasn't been suggested before.
Describe the enhancement you want to request
Summary
Add support for a
namefield inside agent definition files and config so the displayed agent name does not depend on the markdown filename.Currently, according to the docs:
This creates unnecessary coupling between filesystem naming and runtime/UI naming.
Problem
Right now the filename fully determines the agent name. This causes several issues:
Additionally, OpenCode automatically uppercases the first letter of the derived name, which breaks certain naming conventions.
Example:
opencode_auditor.mdOpencode_auditorinstead ofopencode_auditorProposed Solution
Support a dedicated
namefield in the agent file frontmatter the same way asdescriptionis present.Example:
Similar field should also be present in
opencode.jsonconfig file underagentsection.Expected Behavior
nameis present, use it exactly as provided.nameis absent, preserve the current filename-based fallback behavior for backward compatibility.Benefits