So funktioniert es

Diese Seite erklärt, was devkit auf deine Maschine legt, wie Updates ankommen und was es nie anfasst. Die Tagesarbeit braucht nichts davon.

Ein Setup pro Maschine, nicht pro Projekt

Das geteilte Setup — Skills, Agents, Rules, Hooks, Scripts — ist ein signiertes, versioniertes Release, einmal pro Maschine installiert. Projekte behalten nur ihren eigenen Kontext und ihre Berechtigungen.

Schicht	Inhalt	Wo sie liegt
Geteiltes Setup	Skills, Agents, Rules, Hooks, Scripts, Workflows, Themes	~/.onedot-devkit, verlinkt nach ~/.claude/, an einer Session-Grenze aktualisiert
Projektkontext	Fakten, Konventionen, Entscheidungen, Berechtigungen	Im Projekt committet, dem Projekt gehörend
Maschinen-Tools	CLI-Tools und Claude-Plugins	Installiert durch devkit sync

Updates

Ein Release wird geprüft, bevor es benutzt wird: Signatur, Version, Channel, Größe und Checksumme müssen passen, sonst wird der Download verworfen und die aktuelle Version bleibt. Ein Session-Start aktiviert ein geprüftes Release, indem er einen Symlink umschaltet, und holt dann das nächste im Hintergrund; eine laufende Session wird nie unter dir verändert, und jede frühere Version bleibt für devkit rollback verfügbar.

Befehl	Ergebnis
devkit sync	holt, prüft, aktiviert und installiert Tools jetzt
devkit fetch	prüft und stellt eine Version bereit, ohne sie zu aktivieren
devkit apply	aktiviert die bereitgestellte Version, ohne zu holen
devkit rollback [version]	wechselt zurück zu einer früher installierten Version
devkit config channel stable|latest	stable ist der Team-Channel, latest der frühe Channel

devkit doctor meldet eine Update-Prüfung, die älter als 48 Stunden ist, als veraltet. Eine Maschine lehnt eine Remote-Version ab, die älter ist als die bereits geprüfte; devkit rollback ist der Weg zurück.

Was deins bleibt

• Gleichnamige persönliche Dateien gewinnen. Ein persönlicher Skill, Agent, eine Rule oder ein Hook mit demselben Namen wie ein geteilter bleibt unangetastet; der geteilte bleibt inaktiv, und devkit doctor nennt die Kollision.
• Deine Einstellungen gewinnen. Werte wie das Haupt-model werden nur gesetzt, wenn sie fehlen.
• Nur devkits eigene Links werden entfernt. devkit off entfernt Links und Hook-Verdrahtung und behält Version und Config; devkit unlink entfernt auch den lokalen Zustand. MCP-Client-Einträge und persönliche Konfiguration überleben beides.
• Fehler sind sichtbar. Ein Tool, das sich nicht installieren lässt, lässt devkit sync scheitern statt fertig werden; ein gescheitertes Update zeigt devkit doctor an, statt es als erledigt zu melden.

Quellen

Die Standardquelle ist der signierte Endpunkt. Maintainer können eine Maschine auf einen Checkout zeigen lassen und ihn im Dev-Modus fahren:

bash

devkit config source-http https://devkit.one-dot.io
devkit config source-local /pfad/zu/onedot-devkit

Claude Code ist die primäre Runtime; Codex und OpenCode erhalten dasselbe Setup über Runtime-Adapter.