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

Aperta Adatta ai principianti
#64,175 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@yash-alla ci sta già lavorando.

Dal 16/11/2026.

  • #64287 di @yash-alla — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
72/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
cli

Direzione di ricerca

Segui come opencode plugin list crea la colonna ID e legge i dati dei plugin, partendo dal comando CLI e dai relativi test. Confronta i dati del registro lato server con il nome del pacchetto già mostrato in SOURCE, quindi aggiungi un fallback utile per i plugin configurati solo in TUI. Il lavoro è completato quando la colonna ID mostra un valore significativo per un plugin configurato solo in cli.json e i test pertinenti passano.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.
Lingua principale
TypeScript
Stelle
227k
Fork
30.7k
Merge medio
4h 35m
PR unite (30g)
498

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di anomalyco/opencode

Tutte le issue di anomalyco/opencode

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.