DEEN

DokuMit Alran arbeiten

Plugins, Skills und Hooks

Skills bringen Alran eine Art Arbeit bei, Plugins bündeln Skills, MCP-Server und Hooks. Viele sind eingebaut.

Welche Skills sind eingebaut?

Alran Code bringt Skills für Code-Review, gründliche Recherche, Word-Dokumente, Tabellen, Foliensätze, PDFs und zum Schreiben neuer Skills mit. Sie funktionieren offline, direkt nach der Installation. /skills listet sie, /review prüft deine lokalen Änderungen.

Der Plugin Store und die Skill-Bibliothek

Der Plugin Store bietet Plugins aus einem oder mehreren Stores an; die Skill-Bibliothek ist derselbe Katalog als einzelne Skills. Alran Code liest den Store, den Ottili betreibt: Skills und Plugins aus Open-Source-Projekten und von Plattform-Anbietern, unverändert und mit ihren Lizenzen.

bash
alran plugin search <begriffe>       # ein Plugin finden
alran plugin info <name>             # was drin ist und was es ausführt, vor der Installation
alran plugin install <name>
alran skills search <begriffe>       # einen einzelnen Skill finden
alran skills install <name>
alran plugin marketplace add <url>   # zusätzlich einen weiteren Store lesen

In der TUI öffnet /plugin den Store und /skills library die Skill-Bibliothek: tippen zum Suchen, Enter installiert oder aktualisiert, Leertaste schaltet ein Plugin an oder aus, Entf entfernt es.

Jeder Download wird gegen SHA-256 und Inhalts-Digest aus dem Index des Stores geprüft, bevor etwas geschrieben wird. Ein Plugin, das Befehle ausführt oder sich mit Diensten verbindet, siehst du vorher: Du bestätigst die Liste, sonst wird es nicht installiert. Alran überschreibt nie ein Plugin oder einen Skill, den du selbst dorthin gelegt hast. Ein Store ist allerdings nicht signiert: Wer ihn kontrolliert, bestimmt, was er anbietet. Füge nur Stores hinzu, denen du vertraust (alran plugin marketplace add <url>). ALRAN_STORE_URL=off schaltet den Store von Ottili ab.

Plugins verwalten

bash
alran plugins list                 # installierte Plugins
alran plugins list --available     # plus das Angebot der Stores
alran plugins update [name]
alran plugins disable <name>
alran plugins enable <name>
alran plugins remove <name>
alran plugins marketplace list     # Stores und der lokale Plugin-Ordner

/reload lädt Plugins nach einer Änderung neu.

Lokale Plugins

Ein Ordner in ~/.alran/plugins/<name> ist ein installiertes Plugin. Alran liest drei Manifest-Formate:

FormatManifest
Alran.alran-plugin/plugin.json
Claude Code.claude-plugin/plugin.json
Codex.codex-plugin/plugin.json

Die Skills und MCP-Server, die du schon mit einem anderen Agenten nutzt, kommen also mit.

Ein Plugin schreiben

Ein Plugin ist ein Ordner mit .alran-plugin/plugin.json: Name, Version, Beschreibung, Autor, Icon, Kategorie und mindestens eines von Skills, MCP-Servern, Apps oder Hooks. Prüfen kannst du es mit node tools/plugins/validate-plugin.mjs <ordner> aus dem Alran-Code-Repository.

Hooks

Hooks führen deine eigenen Befehle an festen Punkten aus: wenn eine Sitzung startet, vor und nach einem Werkzeug, bei einer Berechtigungsanfrage, wenn ein Subagent startet oder endet und wenn eine Runde fertig ist (Stop). Ein Hook, der eine systemMessage ausgibt, zeigt einen Hinweis in der TUI, ohne ihn in den Kontext des Modells zu legen:

json
{
  "hooks": {
    "Stop": [{
      "hooks": [{ "type": "command", "command": "node \"${PLUGIN_ROOT}/scripts/notice.cjs\"", "timeout": 5 }]
    }]
  }
}

Häufige Fragen

Welche Skills sind eingebaut?

Alran Code bringt Skills für Code-Review, gründliche Recherche, Word-Dokumente, Tabellen, Foliensätze, PDFs und zum Schreiben neuer Skills mit. Sie funktionieren offline direkt nach der Installation, der Befehl /skills listet sie und /review prüft deine lokalen Änderungen.

Wie installiere ich ein Plugin aus dem Store?

Nutze alran plugin search und alran plugin install, oder alran skills search und alran skills install für einen einzelnen Skill. Jeder Download wird gegen SHA-256 und den Inhalts-Digest aus dem Index des Stores geprüft, und ein Plugin, das Befehle ausführt oder sich mit Diensten verbindet, siehst du vor der Installation.

Wie nutze ich meinen eigenen Plugin-Ordner?

Ein Ordner in ~/.alran/plugins, den du selbst benennst, ist ein installiertes Plugin. Alran liest drei Manifest-Formate: .alran-plugin/plugin.json für Alran, .claude-plugin/plugin.json für Claude Code und .codex-plugin/plugin.json für Codex, damit die Skills und MCP-Server mitkommen, die du schon nutzt.