agent description used in /agent command are cutoff #3157

Open
opened 2026-02-16 17:38:54 -05:00 by yindo · 6 comments
Owner

Originally created by @ferrao on GitHub (Nov 27, 2025).

Originally assigned to: @dibenkobit on GitHub.

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:

Image

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

  1. Create a new agent using the command opencode agent create
  2. Launch opencode
  3. Run the /agents command

Screenshot and/or share link

No response

Operating System

No response

Terminal

Ghostty

Originally created by @ferrao on GitHub (Nov 27, 2025). Originally assigned to: @dibenkobit on GitHub. ### 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: <img width="640" height="297" alt="Image" src="https://github.com/user-attachments/assets/789f0c50-f291-4471-b6e0-1e915e5e0723" /> 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 1. Create a new agent using the command `opencode agent create` 2. Launch opencode 3. Run the `/agents` command ### Screenshot and/or share link _No response_ ### Operating System _No response_ ### Terminal Ghostty
yindo added the help-wantedopentuibuggood first issue labels 2026-02-16 17:38:54 -05:00
Author
Owner

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

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

  • #4331: [FEATURE]: word wraping / horisontal scrolling while showing agent edits - Related UI readability issue for long content in the TUI, which shares the same underlying problem of displaying verbose content in the terminal interface.

Feel free to ignore if this doesn't address your specific case.

@github-actions[bot] commented on GitHub (Nov 27, 2025): This issue might be a duplicate of existing issues. Please check: - #4331: [FEATURE]: word wraping / horisontal scrolling while showing agent edits - Related UI readability issue for long content in the TUI, which shares the same underlying problem of displaying verbose content in the terminal interface. Feel free to ignore if this doesn't address your specific case.
Author
Owner

@ferrao commented on GitHub (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 /agents command is wrong.

@ferrao commented on GitHub (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 `/agents` command is wrong.
Author
Owner

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

@rekram1-node commented on GitHub (Dec 1, 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
Author
Owner

@dibenkobit commented on GitHub (Dec 3, 2025):

I've started working on this, will open a PR soon.

@dibenkobit commented on GitHub (Dec 3, 2025): I've started working on this, will open a PR soon.
Author
Owner

@rekram1-node commented on GitHub (Dec 3, 2025):

sounds good, thanks!

@rekram1-node commented on GitHub (Dec 3, 2025): sounds good, thanks!
Author
Owner

@dibenkobit commented on GitHub (Dec 5, 2025):

Opened a PR (#5117), please take a look when you have time :)

@dibenkobit commented on GitHub (Dec 5, 2025): Opened a PR (#5117), please take a look when you have time :)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3157