sccs 2.41.0

SkillsCommandsConfigsSync - Unified YAML-configured synchronization for Claude Code files

SCCS — SkillsCommandsConfigsSync

Language / Sprache: Deutsch | English

Version: 2.40.0 · Lizenz / License: AGPL-3.0 · Python: ≥ 3.10

---

Deutsche Dokumentation

Was ist SCCS?

SCCS ist ein YAML-konfiguriertes, bidirektionales Synchronisierungswerkzeug für Claude Code Dateien (Skills, Commands, Hooks, Agents, Scripts) und optionale Shell-Konfigurationen (Fish, Starship, PowerShell). Es hält deine ~/.claude/-Installation und ein Git-Repository deckungsgleich — über mehrere Maschinen, mehrere Plattformen, mehrere Identitäten hinweg.

Was kann SCCS?

• 🔄 Bidirektionale Synchronisierung zwischen ~/.claude/ und Git-Repository, mit interaktiver Konfliktauflösung und automatischen Backups → docs/usage/sync.md
• 🩺 System & Plugin Health-Check (sccs doctor) für Node.js, claude CLI, Claude-Plugins, npm-Helper-Tools, Browser-Bundles und Filesystem-Permissions — mit gezielten Reparatur-Plänen → docs/usage/doctor.md
• 🧹 sccs doctor optimize (v2.30.0) — Ein-Schuss-Optimierungslauf: install + update + Drift-Warnung für Plugins/MCP-Server außerhalb der Spec. Mit --strict werden Uninstall-Actions per Confirm gequeut.
• 🔧 doctor.disallowed_hooks (v2.31.0) — Substring-Patterns entfernen unerwünschte Hooks aus ~/.claude/settings.json nach jedem doctor-Pass (z.B. Hooks die von npx-Tools re-injiziert werden). Mit Backup, idempotent.
• 🛡️ doctor.protected_hooks (v2.32.0) — harter Schutzwall (Default gsd-): geschützte Hooks werden NIE entfernt, auch wenn ein disallowed_hooks-Pattern matcht (protection wins). GSD-Hooks überleben jeden doctor-Pass.
• ⚡ Auto-Update sicherer Wartung (v2.32.0) — sccs doctor update/optimize führt Plugin-Install/Update, npx-Refresh (inkl. GSD), Marketplace- und Bundled-Skill-Schritte ohne Nachfrage aus; destruktive Actions (Uninstall, Hook-Removal) bleiben confirm-pflichtig.
• 📦 Selektiver Export/Import als ZIP-Archiv (Checkbox-Auswahl) für Kundendeployments → docs/usage/transfer.md
• 🧠 Memory Bridge — file-basierter persistenter Kontext zwischen Claude Code (Terminal) und Claude.ai (Web), inklusive sccs memory CRUD-CLI → docs/usage/memory-bridge.md
• 🔀 OpenCode-Integration (v2.37.0) — sccs integrations opencode exportiert Claude-Artefakte one-way nach OpenCode: Skills/Rules werden nativ gelesen, Agents/Commands per Frontmatter-Konvertierung materialisiert, MCP-Server in opencode.json gemerged → docs/usage/opencode.md
• 🎯 Dynamische Modell-Zuordnung (v2.38.0) — opencode map-models löst Claude-Modelle gegen die real verfügbaren OpenCode-Modelle auf (opencode models-Discovery + Familien-Match), konfigurierbar über opencode.model_map, statischer Fallback offline → docs/usage/opencode.md
• 🚫 OpenCode-Export ohne Plugin-Müll (v2.39.0) — opencode status/export-agents/export-commands schließen doctor-gemanagte Artefakte (gsd-*, playwright-cli — dasselbe Registry wie der Sync) per Default aus; eigene Agents/Commands bleiben. Eigene Patterns via opencode.exclude, explizites -a/-c umgeht den Exclude → docs/usage/opencode.md
• 🧹 GSD-Umzug + Orphan-Cleanup (v2.40.0) — Doctor folgt GSD von @opengsd/get-shit-done-redux (deprecated) auf @opengsd/gsd-core und räumt verwaiste gsd-*-Skills/Agents auf: doctor check meldet sie, doctor update verschiebt sie (kein Hard-Delete, confirm-gated) nach ~/.config/sccs/gsd-orphans-backup-<ts>/. Node-Mindestversion 22 → docs/usage/doctor.md
• 🥧 Pi-Integration (v2.41.0) — sccs integrations pi exportiert Claude-Artefakte one-way nach Pi: Skills (Verzeichnis-Kopie) und Agents (als Einzel-Skills) → ~/.pi/agent/skills/, Commands → ~/.pi/agent/prompts/. Format-identisch zu Claude Code, daher verbatim kopiert (keine Konvertierung, kein Modell-Mapping); gsd-* per Default ausgeschlossen → docs/usage/pi.md
• 🪟 Plattformübergreifend macOS, Linux, Windows mit nativer PowerShell-7-Unterstützung und Fish→PowerShell-Konvertierung → docs/usage/platforms.md
• 🗂️ Mehr als 30 vordefinierte Kategorien mit Plattform-Filtern, anpassbaren Include/Exclude-Patterns und Sync-Modi → docs/usage/categories.md

Voraussetzungen

UV muss installiert sein:

Betriebssystem	Befehl
macOS	brew install uv
Linux / WSL	curl -LsSf https://astral.sh/uv/install.sh | sh
Windows	powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Installation

# Als CLI-Tool installieren (empfohlen)
uv tool install sccs

# Aktualisieren
uv tool upgrade sccs

Für Entwickler:

git clone https://github.com/equitania/sccs.git
cd sccs
uv venv --python 3.13 && source .venv/bin/activate
uv pip install -e ".[dev]"
sccs --help

Quick Start

sccs config init                 # Konfiguration erstellen
sccs status                      # Status anzeigen
sccs sync --dry-run              # Vorschau der Änderungen
sccs sync                        # Synchronisieren
sccs doctor check                # System & Plugin Health prüfen

Dokumentation

Datei	Inhalt
docs/usage/sync.md	Sync-Workflow, Schnellstart, Konfiguration, Konfliktauflösung, Backups
docs/usage/doctor.md	sccs doctor — System & Plugin Health, Bundled Skills, Browser-Bundles, Permission-Checks
docs/usage/transfer.md	Export/Import als ZIP-Archive (Customer Deployment)
docs/usage/memory-bridge.md	Memory Bridge: persistenter Kontext zwischen Claude Code und Claude.ai
docs/usage/categories.md	Kategorien-Referenz, Standard-Kategorien, Plattform-Filter
docs/usage/opencode.md	OpenCode-Integration: Agents/Commands exportieren, Modell-Mapping, MCP-Merge
docs/usage/pi.md	Pi-Integration: Skills/Agents/Commands nach Pi (pi.dev) exportieren
docs/usage/platforms.md	Windows/PowerShell-Support, Fish→PowerShell-Konvertierung
docs/usage/cli-reference.md	Vollständige CLI-Befehlsreferenz
docs/architecture.md	Modul-Layout, Test-Setup, Quality-Gate
RELEASE_NOTES.md	Versions-Historie und Changelog

Lizenz

AGPL-3.0 — Equitania Software GmbH

---

English Documentation

What is SCCS?

SCCS is a YAML-configured, bidirectional synchronization tool for Claude Code files (skills, commands, hooks, agents, scripts) and optional shell configurations (Fish, Starship, PowerShell). It keeps your ~/.claude/ installation and a Git repository in lockstep — across multiple machines, multiple platforms, multiple identities.

What can SCCS do?

• 🔄 Bidirectional sync between ~/.claude/ and a Git repository, with interactive conflict resolution and automatic backups → docs/usage/sync.md
• 🩺 System & plugin health check (sccs doctor) for Node.js, the claude CLI, Claude plugins, npm helper tools, browser bundles and filesystem permissions — with surgical repair plans → docs/usage/doctor.md
• 🧹 sccs doctor optimize (v2.30.0) — one-shot optimisation pass: install + update + drift warning for plugins/MCP servers outside the spec. With --strict, uninstall actions are queued per confirm.
• 🔧 doctor.disallowed_hooks (v2.31.0) — substring patterns strip unwanted hooks from ~/.claude/settings.json after every doctor pass (e.g. hooks re-injected by npx tools). Backup-aware, idempotent.
• 🛡️ doctor.protected_hooks (v2.32.0) — hard guard (default gsd-): protected hooks are NEVER stripped, even when a disallowed_hooks pattern matches (protection wins). GSD hooks survive every doctor pass.
• ⚡ Auto-update for safe maintenance (v2.32.0) — sccs doctor update/optimize runs plugin install/update, npx refresh (incl. GSD), marketplace and bundled-skill steps without prompts; destructive actions (uninstall, hook removal) keep their confirm gate.
• 📦 Selective export/import as ZIP archives (checkbox selection) for customer deployments → docs/usage/transfer.md
• 🧠 Memory Bridge — file-based persistent context between Claude Code (terminal) and Claude.ai (web), including a full sccs memory CRUD CLI → docs/usage/memory-bridge.md
• 🔀 OpenCode integration (v2.37.0) — sccs integrations opencode exports Claude artefacts one-way to OpenCode: skills/rules are read natively, agents/commands are materialised via frontmatter conversion, MCP servers are merged into opencode.json → docs/usage/opencode.md
• 🎯 Dynamic model mapping (v2.38.0) — opencode map-models resolves Claude models against the models your OpenCode install actually offers (opencode models discovery + family match), configurable via opencode.model_map, with a static fallback when offline → docs/usage/opencode.md
• 🚫 OpenCode export skips plugin clutter (v2.39.0) — opencode status/export-agents/export-commands exclude doctor-managed artefacts (gsd-*, playwright-cli — the same registry the sync engine honours) by default; your own agents/commands stay. Add your own patterns via opencode.exclude; an explicit -a/-c selection bypasses the exclude → docs/usage/opencode.md
• 🧹 GSD move + orphan cleanup (v2.40.0) — Doctor follows GSD from @opengsd/get-shit-done-redux (deprecated) to @opengsd/gsd-core and cleans up orphaned gsd-* skills/agents: doctor check reports them, doctor update moves them (no hard-delete, confirm-gated) to ~/.config/sccs/gsd-orphans-backup-<ts>/. Minimum Node version is now 22 → docs/usage/doctor.md
• 🥧 Pi integration (v2.41.0) — sccs integrations pi exports Claude artefacts one-way to Pi: skills (directory copy) and agents (as individual skills) → ~/.pi/agent/skills/, commands → ~/.pi/agent/prompts/. Format-identical to Claude Code, so copied verbatim (no conversion, no model mapping); gsd-* excluded by default → docs/usage/pi.md
• 🪟 Cross-platform macOS, Linux, Windows with native PowerShell 7 support and Fish→PowerShell conversion → docs/usage/platforms.md
• 🗂️ Over 30 predefined categories with platform filters, customizable include/exclude patterns and sync modes → docs/usage/categories.md

Prerequisites

UV must be installed:

OS	Command
macOS	brew install uv
Linux / WSL	curl -LsSf https://astral.sh/uv/install.sh | sh
Windows	powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Installation

# Install as CLI tool (recommended)
uv tool install sccs

# Update
uv tool upgrade sccs

For developers:

git clone https://github.com/equitania/sccs.git
cd sccs
uv venv --python 3.13 && source .venv/bin/activate
uv pip install -e ".[dev]"
sccs --help

Quick Start

sccs config init                 # Initialize configuration
sccs status                      # Show sync status
sccs sync --dry-run              # Preview changes
sccs sync                        # Synchronize
sccs doctor check                # System & plugin health check

Documentation

File	Content
docs/usage/sync.md	Sync workflow, quick start, configuration, conflict resolution, backups
docs/usage/doctor.md	sccs doctor — system & plugin health, bundled skills, browser bundles, permission checks
docs/usage/transfer.md	Export/Import as ZIP archives (customer deployment)
docs/usage/memory-bridge.md	Memory Bridge: persistent context between Claude Code and Claude.ai
docs/usage/categories.md	Category reference, default categories, platform filters
docs/usage/opencode.md	OpenCode integration: export agents/commands, model mapping, MCP merge
docs/usage/pi.md	Pi integration: export skills/agents/commands to Pi (pi.dev)
docs/usage/platforms.md	Windows/PowerShell support, Fish→PowerShell conversion
docs/usage/cli-reference.md	Full CLI command reference
docs/architecture.md	Module layout, test setup, quality gate
RELEASE_NOTES.md	Version history and changelog

License

AGPL-3.0 — Equitania Software GmbH