Metadata-Version: 2.4
Name: sccs
Version: 2.29.1
Summary: SkillsCommandsConfigsSync - Unified YAML-configured synchronization for Claude Code files
Project-URL: Homepage, https://github.com/equitania/sccs
Project-URL: Repository, https://github.com/equitania/sccs
Project-URL: Documentation, https://github.com/equitania/sccs#readme
Project-URL: Issues, https://github.com/equitania/sccs/issues
Author-email: Equitania Software GmbH <info@equitania.de>
Maintainer-email: Equitania Software GmbH <info@equitania.de>
License-Expression: AGPL-3.0
License-File: LICENSE
Keywords: claude,claude-code,commands,configuration,dotfiles,skills,sync
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Version Control
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: click<9.0.0,>=8.1.0
Requires-Dist: pydantic<3.0.0,>=2.0.0
Requires-Dist: pyyaml<7.0.0,>=6.0
Requires-Dist: questionary<3.0.0,>=2.0.0
Requires-Dist: rich<15.0.0,>=13.0.0
Provides-Extra: dev
Requires-Dist: bandit>=1.9.0; extra == 'dev'
Requires-Dist: mypy>=1.14.0; extra == 'dev'
Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.11.0; extra == 'dev'
Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# SCCS — SkillsCommandsConfigsSync

![SCCS Overview](sccs-openai.png)

> **Language / Sprache**: [Deutsch](#deutsche-dokumentation) | [English](#english-documentation)

**Version:** 2.27.1 · **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](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](docs/usage/doctor.md)
- 📦 **Selektiver Export/Import** als ZIP-Archiv (Checkbox-Auswahl) für Kundendeployments → [docs/usage/transfer.md](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](docs/usage/memory-bridge.md)
- 🪟 **Plattformübergreifend** macOS, Linux, Windows mit nativer PowerShell-7-Unterstützung und Fish→PowerShell-Konvertierung → [docs/usage/platforms.md](docs/usage/platforms.md)
- 🗂️ **Mehr als 30 vordefinierte Kategorien** mit Plattform-Filtern, anpassbaren Include/Exclude-Patterns und Sync-Modi → [docs/usage/categories.md](docs/usage/categories.md)

### Voraussetzungen

[UV](https://docs.astral.sh/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

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

# Aktualisieren
uv tool upgrade sccs
```

**Für Entwickler:**

```bash
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

```bash
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](docs/usage/sync.md) | Sync-Workflow, Schnellstart, Konfiguration, Konfliktauflösung, Backups |
| [docs/usage/doctor.md](docs/usage/doctor.md) | `sccs doctor` — System & Plugin Health, Bundled Skills, Browser-Bundles, Permission-Checks |
| [docs/usage/transfer.md](docs/usage/transfer.md) | Export/Import als ZIP-Archive (Customer Deployment) |
| [docs/usage/memory-bridge.md](docs/usage/memory-bridge.md) | Memory Bridge: persistenter Kontext zwischen Claude Code und Claude.ai |
| [docs/usage/categories.md](docs/usage/categories.md) | Kategorien-Referenz, Standard-Kategorien, Plattform-Filter |
| [docs/usage/platforms.md](docs/usage/platforms.md) | Windows/PowerShell-Support, Fish→PowerShell-Konvertierung |
| [docs/usage/cli-reference.md](docs/usage/cli-reference.md) | Vollständige CLI-Befehlsreferenz |
| [docs/architecture.md](docs/architecture.md) | Modul-Layout, Test-Setup, Quality-Gate |
| [RELEASE_NOTES.md](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](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](docs/usage/doctor.md)
- 📦 **Selective export/import** as ZIP archives (checkbox selection) for customer deployments → [docs/usage/transfer.md](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](docs/usage/memory-bridge.md)
- 🪟 **Cross-platform** macOS, Linux, Windows with native PowerShell 7 support and Fish→PowerShell conversion → [docs/usage/platforms.md](docs/usage/platforms.md)
- 🗂️ **Over 30 predefined categories** with platform filters, customizable include/exclude patterns and sync modes → [docs/usage/categories.md](docs/usage/categories.md)

### Prerequisites

[UV](https://docs.astral.sh/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

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

# Update
uv tool upgrade sccs
```

**For developers:**

```bash
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

```bash
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](docs/usage/sync.md) | Sync workflow, quick start, configuration, conflict resolution, backups |
| [docs/usage/doctor.md](docs/usage/doctor.md) | `sccs doctor` — system & plugin health, bundled skills, browser bundles, permission checks |
| [docs/usage/transfer.md](docs/usage/transfer.md) | Export/Import as ZIP archives (customer deployment) |
| [docs/usage/memory-bridge.md](docs/usage/memory-bridge.md) | Memory Bridge: persistent context between Claude Code and Claude.ai |
| [docs/usage/categories.md](docs/usage/categories.md) | Category reference, default categories, platform filters |
| [docs/usage/platforms.md](docs/usage/platforms.md) | Windows/PowerShell support, Fish→PowerShell conversion |
| [docs/usage/cli-reference.md](docs/usage/cli-reference.md) | Full CLI command reference |
| [docs/architecture.md](docs/architecture.md) | Module layout, test setup, quality gate |
| [RELEASE_NOTES.md](RELEASE_NOTES.md) | Version history and changelog |

### License

AGPL-3.0 — Equitania Software GmbH
