Doku / Nachschlagen
Module entwickeln
Eigene Erweiterungen für AyCode bauen, ohne den Quellcode von AyCode: ein Ordner, ein Programm, klare Rechte.
Auf dieser Seite
In einer Minute zum ersten Modul
- Einstellungen → Module → Neues Modul anlegen und einen leeren Ordner wählen.
- AyCode schreibt ein Modul, das sofort läuft: Manifest
aycode-module.json, ein Skill, ein Programm inserver/index.mjsmit dem SDKserver/aycode.mjsund Tests. Der Ordner ist danach verknüpft. - Die Karte des Moduls zeigt, was es darf. Erlauben und einschalten, dann im Chat $name-des-moduls erwähnen.
- Tests laufen ohne AyCode:
node --test server/index.test.mjs.
Das SDK ist eine einzige Datei ohne Abhängigkeiten (Node 18 oder neuer). Die Anleitung liegt im neuen Ordner als README.md.
Getrennt von AyCode
Eigener Code läuft als eigenes Programm, ein MCP-Server, den die Agenten aufrufen, nie in AyCode selbst. Mit AyCode spricht das Programm nur über die Modul-Schnittstelle: nur auf diesem Computer (127.0.0.1), mit einem eigenen Schlüssel pro Modul, versioniert. Über die Schnittstelle kann ein Modul nicht für ein anderes sprechen und nicht dessen Speicher lesen.
Auf dem Mac läuft das Programm abgeschottet (macOS-Sandbox): Es liest das System, seine Laufzeit (Node) und seinen eigenen Ordner, aber nichts in deinem Benutzerordner, also weder Vault noch Projekte noch Schlüssel. Schreiben darf es nur in seinen Datenordner (AYCODE_MODULE_DATA) und seinen Temp-Ordner. Ins Netz kommt es nur zu AyCode, ins Internet nur mit dem Recht network. Andere Programme kann es nicht für sich arbeiten lassen. Lässt sich ein Programm nicht abschotten, startet AyCode es auf dem Mac gar nicht, und die Karte des Moduls sagt warum.
Auf Windows und Linux gibt es diese Abschottung noch nicht: Dort läuft das Programm mit deinen Benutzerrechten und kann alles, was du auch kannst. Die Rechte regeln dort nur, was AyCode ihm gibt. Die Grenze ist dann die Herkunft: öffentliche Module müssen signiert sein, und einem Herausgeber vertraust du bewusst. Die Karte jedes Moduls sagt, ob sein Programm abgeschottet läuft.
Rechte
Eigene Einstellungen und eigenen Speicher darf jedes Modul nutzen. Alles andere steht im Manifest unter permissions, und du bestätigst es vor dem Einschalten. Verlangt ein Update mehr, fragt AyCode erneut.
| Recht | Was das Modul darf |
|---|---|
brain:read | Notizen im zweiten Hirn suchen und lesen, Gemerktes abfragen |
brain:propose | Änderungen an Notizen vorschlagen; du bestätigst jede einzeln |
notify | Hinweise in AyCode zeigen, höchstens sechs pro Minute |
projects:read | deine Projekte und ihre Ordner sehen |
network | Verbindungen ins Internet aufbauen (auf dem Mac ohne dieses Recht gesperrt) |
Die Schnittstelle
| Aufruf im SDK | Recht |
|---|---|
aycode.app.info() | immer |
aycode.settings() | immer |
aycode.storage.get / set / delete / keys | immer (4 MB je Modul) |
aycode.brain.search / note / related / memory | brain:read |
aycode.brain.proposeNote({ path, text, reason }) | brain:propose |
aycode.notify(text) | notify |
aycode.projects.list() | projects:read |
Fehler kommen mit einem Code (forbidden, off, unavailable …) und einer verständlichen Meldung. Wer in einer anderen Sprache schreibt, nutzt das Protokoll direkt: POST /v1/call mit dem Schlüssel des Moduls; Adresse und Schlüssel gibt AyCode dem Programm als Umgebungsvariablen mit.
Weitergeben
- Privat: nur für dich, darf unsigniert sein.
- Öffentlich: für alle, muss mit deinem Herausgeber-Schlüssel signiert sein. Jede Version mit demselben Schlüssel, sonst nimmt AyCode das Update nicht an.
- Lizenziert: für Käufer mit Lizenzschlüssel, den du mit demselben Schlüssel ausstellst. AyCode prüft ihn ohne Netz.
Gepackt wird ein Modul zu einer .aymodule-Datei, die man unter Module → Modul installieren öffnet.