cli: plugin list shows - for ID of TUI-only plugins configured in cli.json

Đang mở Phù hợp với người mới
#64,175 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@yash-alla đang làm issue này rồi.

Từ ngày 16/11/2026.

  • #64287 của @yash-alla — đang mở

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
cli

Hướng nghiên cứu

Theo dõi cách opencode plugin list tạo cột ID và đọc dữ liệu plugin, bắt đầu từ lệnh CLI và các bài kiểm thử của lệnh đó. So sánh dữ liệu registry phía máy chủ với tên gói đã hiển thị trong SOURCE, sau đó thêm phương án dự phòng hữu ích cho các plugin chỉ được cấu hình trong TUI. Hoàn thành khi cột ID hiển thị giá trị có ý nghĩa cho plugin chỉ được cấu hình trong cli.json và các bài kiểm thử liên quan đều đạt.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

area/cli platform/windows type/feature version/v2

Summary

opencode plugin list shows - in the ID column for TUI-only plugins (packages exporting only ./tui, configured in cli.json), even though the plugin loads and works correctly. The ID column should fall back to something useful — ideally the package name — when the plugin has no server-side registry entry.

Environment

  • opencode version: 2.3.0
  • OS: reproduced on Windows 11, but this is platform-independent CLI output
  • Active plugins: a TUI-only package (exports only ./tui) configured in cli.json, alongside server+TUI packages configured in opencode.json

Reproduction

  1. Publish (or link) a plugin package that exports only a TUI part and declares a TUI id:

    "exports": { "./tui": "./dist/tui.js" }
    
    export default Plugin.define({ id: "usage.quota", setup(ctx) { /* ... */ } })
    
  2. Configure it in ~/.config/opencode/cli.json (the documented location for TUI-only packages):

    { "plugins": ["your-tui-only-plugin"] }
    
  3. Run opencode plugin list, with at least one server+TUI plugin configured in opencode.json for comparison.

Expected Behavior

The ID column should display something useful for TUI-only plugins. Two reasonable fallbacks, in order of preference:

  1. The package name — it is already available and displayed in the SOURCE column, so the data needs no new plumbing.
  2. The TUI part's declared id (e.g. usage.quota) when there is no server-side entry.

Actual Behavior

The ID column shows - for the TUI-only plugin, while server+TUI plugins configured in opencode.json show their IDs:

ID                       VERSION  SOURCE
-                        0.2.2    opencode-coding-quota
<server-plugin-a>        1.0.0    <server-plugin-a>
<server-plugin-b>        1.0.0    <server-plugin-b>

Additional Context

  • The plugin itself works fine (loads in the TUI, renders its UI). This is purely a display issue in plugin list, but it is confusing for plugin authors: it looks like the package is broken or not detected.
  • Verified against the running service via GET /api/plugin: the TUI-only plugin is absent from the server-side registry because it is loaded directly by the TUI from cli.json — by design, per the docs, so it remains active against remote servers. The plugin list ID column appears to read only that server-side registry, hence the -.
  • Reproduced consistently on every invocation.
  • Real-world npm package that triggers this: opencode-coding-quota.
  • No workaround short of adding an empty server part to the package and moving it to opencode.json — which sacrifices the documented remote-server benefit of cli.json for TUI-only packages.
Ngôn ngữ chính
TypeScript
Star
227k
Fork
30.7k
Merge trung bình
4 giờ 35 phút
Pull request đã merge (30 ngày)
498

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của anomalyco/opencode

Tất cả issue của anomalyco/opencode

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.