Skip to main content

SkillsCommandsConfigsSync - Unified YAML-configured synchronization for Claude Code files

Project description

SCCS — SkillsCommandsConfigsSync

SCCS Overview

Language / Sprache: Deutsch | English

Version: 2.31.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.
  • 📦 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
  • 🪟 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/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.
  • 📦 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
  • 🪟 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/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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sccs-2.32.0.tar.gz (2.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sccs-2.32.0-py3-none-any.whl (154.8 kB view details)

Uploaded Python 3

File details

Details for the file sccs-2.32.0.tar.gz.

File metadata

  • Download URL: sccs-2.32.0.tar.gz
  • Upload date:
  • Size: 2.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for sccs-2.32.0.tar.gz
Algorithm Hash digest
SHA256 56532a722293b37f7185df4e11713f6e41a5c71ab770381d7853ea1071e2d610
MD5 4c181c297a2222a04848c1dbc4db3538
BLAKE2b-256 ba6b49e31eeec97ed4a1e34d12558b8d345df60b3d4fbe97ac445cd216e48a77

See more details on using hashes here.

File details

Details for the file sccs-2.32.0-py3-none-any.whl.

File metadata

  • Download URL: sccs-2.32.0-py3-none-any.whl
  • Upload date:
  • Size: 154.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for sccs-2.32.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cff0814fc5b7c2c3d188bf87a3d9f0fe2ed63c22648a76970acef3d59909cbb7
MD5 8c62cb31552b37fcbd2312700c59b690
BLAKE2b-256 3275f54c7aa40899b6995c5b0d3aa7a4f763c8fc1cb10839d17888a3093ac488

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page