Files
opencode-plugins/README.md
T
m3ta-chiron bdeb27b775 feat: explain-permissions v1.3.0 — Erklärungen als Zitat-Block mit Zeilenstruktur
- SYSTEM_PROMPT_RULE: Erklärung als Markdown-Zitat-Block (>) mit fetten
  Labels, jeder Punkt (WAS passiert/WELCHE FOLGEN/WIE RISKANT) auf eigener
  Zeile — bessere Lesbarkeit + visuelle Hervorhebung in TUI und Desktop
  (beide rendern Blockquotes mit farbigem Balken; opencode 1.18.30 bietet
  keinen Anzeige-Transform-Hook, experimental.chat.messages.transform
  wirkt nur modellseitig — verifiziert)
- Desktop-Notifications: neuer plainText()-Filter streicht Markdown-Marker
  (>, **) aus dem Toast-Text
- EXPLAIN_FIRST_ERROR verweist auf das neue Block-Format
- READMEs: Zweck + Versionierung ergänzt, Root-Tabelle auf v1.3.0
2026-09-18 10:06:33 +02:00

48 lines
1.9 KiB
Markdown

# opencode-plugins — kanonische Plugin-Sammlung für opencode
Dieses Repo ist die **eine Wahrheitsquelle** für opencode-Plugins der AZ-Gruppe.
Es ist ein reines Content-Repo: hier leben nur die Plugin-Dateien plus ihre
Doku — die Technik, die sie ausliefert, gehört in das Fleet-Repo `az-fleet`.
Das Repos ist **anonym lesbar** (kein Token für Pulls nötig), Schreiben läuft
über die Organisation AZ-Intec-GmbH.
## Enthaltene Plugins
| Plugin | Zweck | Version |
|---|---|---|
| [`explain-permissions/`](explain-permissions/) | Erklärt jeden freigabepflichtigen Tool-Call laienverständlich (Was/Folgen/Risiko) als hervorgehobener Zitat-Block, Desktop-Notification + Audit-Log | v1.3.0 |
## Struktur & Konventionen
```
opencode-plugins/
└── <plugin-name>/
├── <plugin-name>.js # die Plugin-Datei (genau eine pro Plugin)
└── README.md # Doku: Zweck, Env-Variablen, Logs, Neustart-Hinweis
```
- **Ein Ordner pro Plugin**, Name = Plugin-Name (kebab-case, keine Umlaute).
- Version steht in `PLUGIN_VERSION` im Dateikopf des Plugins.
- **Tags sind pro Plugin benamst**: `<plugin-name>/v<version>` — z. B.
`explain-permissions/v1.1.0`. So kollidieren Versionen verschiedener Plugins
nie. Ein Tag markiert immer exakt den Plugin-Stand bei Freigabe.
- Neue Plugins: Ordner anlegen, in der Tabelle oben eintragen, Commit + Tag.
## Bezug
### Lokale Workstation (Checkout + Symlink)
```bash
git clone https://git.az-gruppe.com/AZ-Intec-GmbH/opencode-plugins.git ~/p/AZ/opencode-plugins
ln -sf ~/p/AZ/opencode-plugins/<plugin-name>/<plugin-name>.js ~/.config/opencode/plugins/<plugin-name>.js
```
Danach opencode **neu starten**. Wichtig: nur EINE Datei dieses Namens im
Plugin-Ordner — sonst lädt opencode das Plugin doppelt.
### Fleet (`az-fleet`)
Pin auf einen Tag (`<plugin-name>/v<version>`) oder `main`; anonymes
`git clone` über HTTPS reicht.