Skip to content

@ mention list omits agent descriptions #49351

Open

Description

@mrt181

Description

Skills in the @ autocomplete show their description. Agents in the same list show only @id.

Agents have descriptions - /api/agent returns them and the subagent chooser uses them. The mention item builder drops the field: the skill builder passes description: skill.description, the agent builder beside it does not.

Plugins

One local plugin, unrelated

OpenCode version

2.0.3

Steps to reproduce

  1. Add ~/.config/opencode/agents/example.md with mode: subagent and a description
  2. Type @ in the composer
  3. Skill entries show descriptions, agent entries do not

Screenshot and/or share link

Image

Operating System

Arch Linux

Terminal

WezTerm 20260905-055013-e019f1b1 (inside tmux 3.7c)

Activity

  1. mrt181 commented on Sep 16, 2026

    @mrt181
    Author

    Follow up: on dev (350c726) skills are no longer in the @ list — it is
    [...referenceAliases, ...agents, ...mcpResources]. The screenshot is 2.0.3,
    where they still were.

  2. opencodejr commented on Oct 28, 2026

    @opencodejr

    Thanks for the clear report. I reproduced this on the latest dev (950111ff).

    I used a project with a mode: subagent agent (example) and a skill (demo-skill), both with a description, and typed @ in the prompt. Every skill entry shows its description. The agent entries (@general, @explore, @example) show only their names and the agent tag. The recording and screenshot below show this, and the script below reproduces it.

    I couldn't drive the 2.0.3 release with our test harness. The 2.0.3 source has the same code you pointed out, though: in packages/tui/src/component/prompt/autocomplete.tsx, agent options are built without description, while skill options pass skill.description. The app composer (packages/app/src/composer/model.ts) leaves it out the same way.

    Related: #47894 asks for agent descriptions in the Desktop agent picker, which is a separate component.

    recording.mp4

    Screenshot

    Reproduction script (drive.ts)
    // Repro for #49351: agents in the `@` mention autocomplete show no description, skills do.
    import { Effect } from "effect"
    import { OpenCodeDriver } from "opencode-drive"
    
    export default OpenCodeDriver.use(
      {
        ...(process.env.OC_DEV ? { opencode: { dev: process.env.OC_DEV } } : {}),
        tui: { recording: true },
        project: {
          git: true,
          files: {
            ".opencode/agents/example.md":
              "---\nmode: subagent\ndescription: Example subagent that reviews code changes\n---\nYou review code.\n",
            ".opencode/skills/demo-skill/SKILL.md":
              "---\nname: demo-skill\ndescription: Demo skill that explains things\n---\nExplain things.\n",
          },
        },
      },
      ({ ui }) =>
        Effect.gen(function* () {
          yield* ui.screenshot("01-home")
          yield* ui.type("@")
          yield* ui.waitFor("@example")
          yield* Effect.sleep(800)
          yield* ui.screenshot("02-mention-list")
          yield* ui.type("ex")
          yield* Effect.sleep(800)
          yield* ui.screenshot("03-mention-filtered")
        }),
    )

    Run it with opencode-drive: opencode-drive run ./drive.ts. It drives opencode from your PATH; set OC_DEV to the path of an OpenCode checkout to run that from source instead.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions