Repository navigation
agent description used in /agent command are cutoff #4825
Description
Description
Whenever you create a new agent with the command opencode agent create, it will result in an agent file with a very extensive description field, which instructs the model on when to use this agent.
The problem is that this field is then used by the /agents command, resulting in something that is impossible to read:
I think the right solution would be to have two different configuration options, one with the long description of what the agent does, which I guess will be used internally by opencode to decide when to invoke this agent, and another short configuration option, that could be used on commands that list the available agents.
OpenCode version
1.0.119
Steps to reproduce
- Create a new agent using the command
opencode agent create - Launch opencode
- Run the
/agentscommand
Screenshot and/or share link
No response
Operating System
No response
Terminal
Ghostty
Activity
github-actions commentedon Nov 27, 2025
This issue might be a duplicate of existing issues. Please check:
Feel free to ignore if this doesn't address your specific case.
ferrao commentedon Nov 27, 2025
I do not think this is a duplicate of #4331 but actually a different thing. Of course horizontal scrolling would help with understanding and reading the agent description, but what I am actually saying is that using a field that we know is going to contain a big paragraph of text for the description of the agents on the
/agentscommand is wrong.rekram1-node commentedon Dec 2, 2025
Yeah we should prolly word wrap here or use "..." truncation with possibility to expand maybe?, i get what ur saying about a human friendly field that isn't a prompt for llm
[-]agent description used in /agent command are impossible to read.[/-][+]agent description used in /agent command don't wrap[/+][-]agent description used in /agent command don't wrap[/-][+]agent description used in /agent command are cutoff[/+]dibenkobit commentedon Dec 3, 2025
I've started working on this, will open a PR soon.
rekram1-node commentedon Dec 3, 2025
sounds good, thanks!
feat(agents): add shortDescription and agent details modal (anomalyco…
fix(agents): improve focus restoration and dynamic description trunca…
fix(agents): improve agent details dialog layout (anomalyco#4825)
docs(agents): update short_description field description (anomalyco#4825
refactor(agents): rename focusedAgent prop to selectedAgent (anomalyc…
refactor(agents): rename maxDescLen to maxDescriptionLength (anomalyc…
refactor(agents): rename shortSummary to shortDescription for consist…
dibenkobit commentedon Dec 5, 2025
Opened a PR (#5117), please take a look when you have time :)
style: format agent.ts and config.ts (anomalyco#4825)
fix(ui): truncate agent description in agent selection dialog
fix(tui): truncate agent descriptions in /agents dialog
feat(agent): add optional title field for better display in agent lists
feat(agent): add optional title field for better display in agent lists
feat(agent): add short description for better UI display (anomalyco#4825