Clevermation CLI

Tool für das Clevermation-Team zur standardisierten Einrichtung von Claude Code Projekten.

Installation

# Mit Bun (empfohlen)
bun add -g @clevermation/cli

# Mit npm
npm install -g @clevermation/cli

# Mit pnpm
pnpm add -g @clevermation/cli

Danach stehen die Commands cl und clever zur Verfügung.

Commands

cl init

Initialisiert ein neues Projekt mit interaktivem Setup.

cl init

Fragt ab:

• Projekt-Typ (Kunde oder Intern)
• Projektname
• Services (Supabase, N8N, ElevenLabs)
• Claude Model Präferenz
• Optimale Projekt-Einstellungen

cl sync

Synchronisiert das Projekt mit GitHub.

cl sync

Funktionen:

• Prüft GitHub CLI Authentifizierung
• Erstellt privates Repo in Clevermation Org (falls nicht vorhanden)
• Pusht Änderungen

cl auth

Verwaltet Authentifizierung für alle Services.

# Status aller Services anzeigen
cl auth

# Bei einem Service anmelden
cl auth login github
cl auth login supabase
cl auth login n8n
cl auth login elevenlabs
cl auth login all  # Alle Services

# Von einem Service abmelden
cl auth logout github

cl doctor

Prüft System-Voraussetzungen und zeigt Probleme.

cl doctor

Prüft:

• Bun, Git, GitHub CLI, Claude Code
• Supabase CLI (optional)
• Auth-Status aller Services

cl open

Öffnet das Projekt in deiner IDE.

# Im Standard-Editor öffnen (VS Code)
cl open

# In spezifischer IDE öffnen
cl open -i cursor
cl open -i webstorm
cl open -i zed

# Standard-IDE setzen
cl open --set-default cursor

cl config

Zeigt und verwaltet Konfiguration.

cl config

cl explain

Erklärt die aktuelle Projektstruktur.

cl explain
cl explain -v  # Verbose mit Verzeichnisbaum

cl update

Aktualisiert CLI und Plugins.

cl update
cl update --cli-only      # Nur CLI
cl update --plugins-only  # Nur Plugins

Features

Auto-Update

Die CLI prüft automatisch auf Updates (max. 1x pro 24h) und zeigt eine Benachrichtigung wenn eine neue Version verfügbar ist.

Auto-Install

Fehlende Voraussetzungen (Bun, Git, GitHub CLI) werden automatisch im Hintergrund installiert.

Optimale Einstellungen

Bei cl init kann optional eine globale ~/.claude/CLAUDE.md erstellt werden mit Clevermation-spezifischen Einstellungen.

Projekt-Struktur nach cl init

mein-projekt/
├── .clevermation/
│   └── config.json       # Projekt-Konfiguration
├── .claude/
│   ├── settings.json     # Claude Code Settings
│   └── settings.local.json  # API Keys (gitignored)
├── .mcp.json             # MCP Server Konfiguration
├── src/
├── docs/
└── .gitignore

Naming Conventions

| Projekt-Typ | Format | Beispiel | |-------------|--------|----------| | Kunde | kunde-projekt | acme-webshop | | Intern | clevermation-projekt | @clevermation/cli |

Alle Repositories werden als privat in der Clevermation Organisation erstellt.

Claude Code Plugins (TODO)

Folgende Plugins sollen für den Marketplace erstellt werden:

• [ ] Supabase Plugin - Datenbank, Auth, Storage, Edge Functions, RLS
• [ ] N8N Plugin - Workflow Automation, Trigger, Nodes
• [ ] ElevenLabs Plugin - Voice AI, Text-to-Speech, Voice Cloning
• [ ] Mermaid/Planning Plugin - Diagramme, Flowcharts, Architektur-Planung

Future Features

• [ ] Projekt-Templates - Vorkonfigurierte Setups (Web-App, Automation, API)
• [ ] cl new <name> - Shortcut für mkdir + cd + init
• [ ] cl plugins - Claude Code Plugins verwalten
• [ ] Erweiterte CLAUDE.md - Manager-Rolle, Subagenten-Orchestrierung, Testing-Workflow
• [ ] Team-Einstellungen sync - Globale Clevermation-Settings synchronisieren

Entwicklung

# Repository klonen
git clone https://github.com/Clevermation/@clevermation/cli.git
cd @clevermation/cli

# Dependencies installieren
bun install

# Lokal ausführen
bun run dev init
bun run dev --help

# Tests
bun test

Release erstellen

Releases werden automatisch über GitHub Actions veröffentlicht:

1. Version in package.json und src/index.ts erhöhen
2. Commit und Push
3. GitHub Release erstellen: gh release create v0.2.0
4. GitHub Action published automatisch zu GitHub Packages

Support

Bei Fragen: #dev-tools Slack Channel