From 239e613100e40c741eadd24c50a2429d3ffd530c Mon Sep 17 00:00:00 2001 From: Serge Koenigsmann Date: Wed, 8 Jul 2026 03:32:38 +0200 Subject: [PATCH] docs: document insteadOf git config for private-repo marketplace access Co-Authored-By: Claude Opus 4.8 --- README.md | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 8dce2db..d7d3074 100644 --- a/README.md +++ b/README.md @@ -5,21 +5,32 @@ und kann einzeln installiert werden — niemand bekommt alles auf einmal. ## Einrichtung (einmalig) -Vollständige Git-URL angeben — die Kurzform `owner/repo` wird von Claude Code -immer als GitHub interpretiert und schlägt bei Gitea fehl. +`/plugin marketplace add` akzeptiert nur `owner/repo` (immer GitHub!), `https://…` +oder einen lokalen `./path` — **kein** `ssh://`. Da dieses Repo privat ist und der +Plugin-Clone nicht interaktiv nach Zugangsdaten fragen kann, muss git HTTPS-Zugriffe +auf das Gitea transparent auf SSH umleiten. Einmalig pro Rechner: ```bash -# SSH (empfohlen, für private Repos nötig) -/plugin marketplace add ssh://gitea@gitea.inmedias.it:2222/inmedias.it/claude-plugins.git +# 1. git so konfigurieren, dass https auf dieses Gitea über SSH (Key) läuft +git config --global url."ssh://gitea@gitea.inmedias.it:2222/".insteadOf "https://gitea.inmedias.it/" -# oder HTTPS (nur wenn Repo öffentlich lesbar) +# 2. Marketplace mit der HTTPS-URL hinzufügen (klont real über SSH) /plugin marketplace add https://gitea.inmedias.it/inmedias.it/claude-plugins.git ``` +Voraussetzung: dein Gitea-SSH-Key ist auf Port 2222 eingerichtet. + +> Hinweis: Die `insteadOf`-Regel gilt für **alle** git-Operationen auf +> `gitea.inmedias.it`, nicht nur für Plugins. +> +> Alternative ohne git-Config: Repo `inmedias.it/claude-plugins` intern/öffentlich +> lesbar machen — dann reicht die HTTPS-URL direkt (SSH-Key trotzdem für Push nötig). + ## Plugin installieren ```bash -/plugin install gitea-tea +/plugin install gitea-tea@inmedias-claude-plugins +/reload-plugins ``` Verfügbare Plugins listet `/plugin` bzw. `marketplace.json`.