zuppaclaude 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hasankaantan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,487 @@
+# 🍝 ZuppaClaude
+
+[![npm version](https://badge.fury.io/js/zuppaclaude.svg)](https://www.npmjs.com/package/zuppaclaude)
+[![npm downloads](https://img.shields.io/npm/dm/zuppaclaude.svg)](https://www.npmjs.com/package/zuppaclaude)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> ⚡ Claude Code için tek komutla kurulum paketi - SuperClaude + Spec Kit + Claude-Z + Claude HUD
+
+<p align="center">
+  <a href="#-türkçe">🇹🇷 Türkçe</a> •
+  <a href="#-english">🇬🇧 English</a>
+</p>
+
+---
+
+## 🇹🇷 Türkçe
+
+### 📦 Nedir?
+
+ZuppaClaude, Claude Code deneyiminizi güçlendiren araçları tek komutla kurar:
+
+| Araç | Açıklama |
+|------|----------|
+| ⚡ **SuperClaude** | 30+ slash komutu ile gelişmiş iş akışları |
+| 📋 **Spec Kit** | Spec-driven development CLI aracı |
+| 🌐 **Claude-Z** | z.ai backend desteği (opsiyonel) |
+| 📊 **Claude HUD** | Gerçek zamanlı durum göstergesi (opsiyonel) |
+| 📝 **CLAUDE.md** | Optimize edilmiş sistem talimatları |
+
+### 🚀 Hızlı Kurulum
+
+#### 📦 NPM ile (Önerilen)
+```bash
+npx zuppaclaude
+```
+
+Veya global kurulum:
+```bash
+npm install -g zuppaclaude
+zuppaclaude
+```
+
+#### 🐚 Shell ile
+
+**🍎 macOS / 🐧 Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/install.sh | bash
+```
+
+**🌍 Alternatif (jsDelivr CDN):**
+```bash
+curl -fsSL https://cdn.jsdelivr.net/gh/hasankaantan/zuppaclaude@main/install.sh | bash
+```
+
+**🪟 Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/install.ps1 | iex
+```
+
+### 📋 Gereksinimler
+
+Kurulum scripti eksik bağımlılıkları otomatik kontrol eder:
+
+| Gereksinim | Açıklama |
+|------------|----------|
+| 💻 **OS** | macOS, Linux veya Windows 10+ |
+| 🐍 **Python** | 3.8 veya üzeri |
+| 📂 **git** | Versiyon kontrol |
+| 🤖 **Claude Code** | Anthropic CLI (önerilir) |
+
+### ✅ Kurulum Sonrası
+
+1. 🔄 **Claude Code'u yeniden başlat**
+
+2. ⚡ **SuperClaude test et:**
+   ```
+   /sc:help
+   ```
+
+3. 📋 **Spec Kit test et:**
+   ```bash
+   specify --help
+   ```
+
+4. 🌐 **Claude-Z test et (kurulduysa):**
+   ```bash
+   claude-z
+   ```
+
+### ⚡ SuperClaude Komutları
+
+#### 🎯 Planlama & Tasarım
+| Komut | Açıklama |
+|-------|----------|
+| `/sc:brainstorm` | 💡 Fikir geliştirme |
+| `/sc:design` | 🏗️ Mimari tasarım |
+| `/sc:estimate` | ⏱️ Zaman/kaynak tahmini |
+| `/sc:spec-panel` | 📑 Spesifikasyon paneli |
+
+#### 💻 Geliştirme
+| Komut | Açıklama |
+|-------|----------|
+| `/sc:implement` | ⚙️ Kod implementasyonu |
+| `/sc:build` | 🔨 Build ve derleme |
+| `/sc:improve` | ✨ Kod iyileştirme |
+| `/sc:explain` | 📖 Kod açıklama |
+
+#### 🧪 Test & Kalite
+| Komut | Açıklama |
+|-------|----------|
+| `/sc:test` | 🧪 Test oluşturma |
+| `/sc:analyze` | 🔍 Kod analizi |
+| `/sc:troubleshoot` | 🐛 Hata ayıklama |
+| `/sc:reflect` | 🪞 Retrospektif |
+
+#### 📊 Proje Yönetimi
+| Komut | Açıklama |
+|-------|----------|
+| `/sc:task` | ✅ Görev yönetimi |
+| `/sc:workflow` | 🔄 İş akışı yönetimi |
+| `/sc:pm` | 📈 Proje yönetimi |
+
+### 📋 Spec Kit İş Akışı
+
+```bash
+specify init         # 🚀 Proje başlat
+specify constitution # 📜 Proje kuralları
+specify spec         # 📋 Fonksiyonel gereksinimler
+specify plan         # 📐 Teknik plan
+specify tasks        # ✅ Görev breakdown
+```
+
+### 🌐 Claude-Z (z.ai Backend)
+
+Kurulum sırasında Z.AI API key'inizi girmeniz istenir ([z.ai](https://z.ai) adresinden alın).
+
+```bash
+# z.ai backend ile Claude Code çalıştır
+claude-z
+```
+
+**🔌 Sağladığı MCP Serverlar:**
+| Server | Açıklama |
+|--------|----------|
+| `web-search-prime` | 🔍 Gelişmiş web arama |
+| `web-reader` | 📄 Web sayfası okuma |
+| `zread` | 📚 Doküman okuma |
+| `zai-mcp-server` | 🔗 Z.AI MCP entegrasyonu |
+
+### 📊 Claude HUD (Durum Göstergesi)
+
+Claude Code'a gerçek zamanlı statusline ekler. Kurulum sırasında etkinleştirmeyi seçebilirsiniz.
+
+**📈 Gösterdikleri:**
+- 📊 Context window kullanımı
+- 🔧 Aktif araçlar ve dosya işlemleri
+- 🤖 Çalışan agent'lar
+- ✅ Todo/görev ilerlemesi
+
+**⚙️ Kurulum sonrası:**
+```bash
+setup-claude-hud  # Talimatları gösterir
+```
+
+Ardından Claude Code içinde:
+```
+/plugin marketplace add jarrodwatts/claude-hud
+/plugin install claude-hud
+/claude-hud:setup
+```
+
+### ⚙️ Ayar Yönetimi
+
+ZuppaClaude seçimlerinizi kaydeder ve tekrar kurulumda otomatik kullanır.
+
+**📦 NPM ile:**
+```bash
+npx zuppaclaude settings show              # 👁️ Ayarları görüntüle
+npx zuppaclaude settings export ~/backup.json  # 💾 Dışa aktar
+npx zuppaclaude settings import ~/backup.json  # 📥 İçe aktar
+npx zuppaclaude settings reset             # 🔄 Fabrika ayarları
+```
+
+**🐚 Shell ile:**
+```bash
+./zc-settings.sh show              # 👁️ Ayarları görüntüle
+./zc-settings.sh export ~/backup.json  # 💾 Dışa aktar
+./zc-settings.sh import ~/backup.json  # 📥 İçe aktar
+./zc-settings.sh reset             # 🔄 Fabrika ayarları
+```
+
+**✨ Özellikler:**
+| Özellik | Açıklama |
+|---------|----------|
+| 💾 Otomatik kayıt | Kurulum sonrası tercihler kaydedilir |
+| ⚡ Hızlı kurulum | Önceki ayarlarla tek komutla kurulum |
+| 🔐 API key koruması | Base64 encoded saklama |
+| 🛡️ Uninstall koruması | Kaldırırken ayarları koruma opsiyonu |
+
+### 🗑️ Kaldırma
+
+**📦 NPM ile:**
+```bash
+npx zuppaclaude uninstall
+```
+
+**🐚 Shell ile:**
+
+**🍎 macOS / 🐧 Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.sh | bash
+```
+
+**🪟 Windows:**
+```powershell
+irm https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.ps1 | iex
+```
+
+### 📁 Dosya Konumları
+
+| Dosya | 🍎🐧 macOS/Linux | 🪟 Windows |
+|-------|------------------|------------|
+| ⚡ SuperClaude | `~/.claude/commands/sc/` | `%USERPROFILE%\.claude\commands\sc\` |
+| 📝 Konfigürasyon | `~/.claude/CLAUDE.md` | `%USERPROFILE%\.claude\CLAUDE.md` |
+| 🌐 Claude-Z | `~/.local/bin/claude-z` | `%USERPROFILE%\.local\bin\claude-z.cmd` |
+| 📊 Claude HUD | `~/.local/bin/setup-claude-hud` | `%USERPROFILE%\.local\bin\setup-claude-hud.cmd` |
+| 🔧 Z.AI Config | `~/.config/zai/` | `%USERPROFILE%\.config\zai\` |
+| ⚙️ Ayarlar | `~/.config/zuppaclaude/` | `%USERPROFILE%\.config\zuppaclaude\` |
+
+---
+
+## 🇬🇧 English
+
+### 📦 What is it?
+
+ZuppaClaude installs tools to supercharge your Claude Code experience with a single command:
+
+| Tool | Description |
+|------|-------------|
+| ⚡ **SuperClaude** | 30+ slash commands for enhanced workflows |
+| 📋 **Spec Kit** | Spec-driven development CLI tool |
+| 🌐 **Claude-Z** | z.ai backend support (optional) |
+| 📊 **Claude HUD** | Real-time status display (optional) |
+| 📝 **CLAUDE.md** | Optimized system instructions |
+
+### 🚀 Quick Install
+
+#### 📦 Via NPM (Recommended)
+```bash
+npx zuppaclaude
+```
+
+Or install globally:
+```bash
+npm install -g zuppaclaude
+zuppaclaude
+```
+
+#### 🐚 Via Shell
+
+**🍎 macOS / 🐧 Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/install.sh | bash
+```
+
+**🌍 Alternative (jsDelivr CDN):**
+```bash
+curl -fsSL https://cdn.jsdelivr.net/gh/hasankaantan/zuppaclaude@main/install.sh | bash
+```
+
+**🪟 Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/install.ps1 | iex
+```
+
+### 📋 Requirements
+
+The installer automatically checks for missing dependencies:
+
+| Requirement | Description |
+|-------------|-------------|
+| 💻 **OS** | macOS, Linux, or Windows 10+ |
+| 🐍 **Python** | 3.8 or higher |
+| 📂 **git** | Version control |
+| 🤖 **Claude Code** | Anthropic CLI (recommended) |
+
+### ✅ After Installation
+
+1. 🔄 **Restart Claude Code**
+
+2. ⚡ **Test SuperClaude:**
+   ```
+   /sc:help
+   ```
+
+3. 📋 **Test Spec Kit:**
+   ```bash
+   specify --help
+   ```
+
+4. 🌐 **Test Claude-Z (if installed):**
+   ```bash
+   claude-z
+   ```
+
+### ⚡ SuperClaude Commands
+
+#### 🎯 Planning & Design
+| Command | Description |
+|---------|-------------|
+| `/sc:brainstorm` | 💡 Idea development |
+| `/sc:design` | 🏗️ Architectural design |
+| `/sc:estimate` | ⏱️ Time/resource estimation |
+| `/sc:spec-panel` | 📑 Specification panel |
+
+#### 💻 Development
+| Command | Description |
+|---------|-------------|
+| `/sc:implement` | ⚙️ Code implementation |
+| `/sc:build` | 🔨 Build and compile |
+| `/sc:improve` | ✨ Code improvement |
+| `/sc:explain` | 📖 Code explanation |
+
+#### 🧪 Testing & Quality
+| Command | Description |
+|---------|-------------|
+| `/sc:test` | 🧪 Test creation |
+| `/sc:analyze` | 🔍 Code analysis |
+| `/sc:troubleshoot` | 🐛 Debugging |
+| `/sc:reflect` | 🪞 Retrospective |
+
+#### 📊 Project Management
+| Command | Description |
+|---------|-------------|
+| `/sc:task` | ✅ Task management |
+| `/sc:workflow` | 🔄 Workflow management |
+| `/sc:pm` | 📈 Project management |
+
+### 📋 Spec Kit Workflow
+
+```bash
+specify init         # 🚀 Initialize project
+specify constitution # 📜 Project rules
+specify spec         # 📋 Functional requirements
+specify plan         # 📐 Technical plan
+specify tasks        # ✅ Task breakdown
+```
+
+### 🌐 Claude-Z (z.ai Backend)
+
+During installation, you'll be asked for your Z.AI API key (get it from [z.ai](https://z.ai)).
+
+```bash
+# Run Claude Code with z.ai backend
+claude-z
+```
+
+**🔌 Provided MCP Servers:**
+| Server | Description |
+|--------|-------------|
+| `web-search-prime` | 🔍 Enhanced web search |
+| `web-reader` | 📄 Web page reading |
+| `zread` | 📚 Document reading |
+| `zai-mcp-server` | 🔗 Z.AI MCP integration |
+
+### 📊 Claude HUD (Status Display)
+
+Adds a real-time statusline to Claude Code. You can enable it during installation.
+
+**📈 What it shows:**
+- 📊 Context window usage
+- 🔧 Active tools and file operations
+- 🤖 Running agents
+- ✅ Todo/task progress
+
+**⚙️ After installation:**
+```bash
+setup-claude-hud  # Shows instructions
+```
+
+Then inside Claude Code:
+```
+/plugin marketplace add jarrodwatts/claude-hud
+/plugin install claude-hud
+/claude-hud:setup
+```
+
+### ⚙️ Settings Management
+
+ZuppaClaude saves your choices and automatically uses them on reinstall.
+
+**📦 Via NPM:**
+```bash
+npx zuppaclaude settings show              # 👁️ View settings
+npx zuppaclaude settings export ~/backup.json  # 💾 Export
+npx zuppaclaude settings import ~/backup.json  # 📥 Import
+npx zuppaclaude settings reset             # 🔄 Reset to defaults
+```
+
+**🐚 Via Shell:**
+
+**🍎🐧 macOS/Linux:**
+```bash
+./zc-settings.sh show              # 👁️ View settings
+./zc-settings.sh export ~/backup.json  # 💾 Export
+./zc-settings.sh import ~/backup.json  # 📥 Import
+./zc-settings.sh reset             # 🔄 Reset to defaults
+```
+
+**🪟 Windows:**
+```powershell
+.\zc-settings.ps1 show
+.\zc-settings.ps1 export ~\backup.json
+.\zc-settings.ps1 import ~\backup.json
+.\zc-settings.ps1 reset
+```
+
+**✨ Features:**
+| Feature | Description |
+|---------|-------------|
+| 💾 Auto-save | Preferences saved after installation |
+| ⚡ Quick reinstall | One-command reinstall with previous settings |
+| 🔐 API key protection | Base64 encoded storage |
+| 🛡️ Uninstall protection | Option to preserve settings when uninstalling |
+
+### 🗑️ Uninstall
+
+**📦 Via NPM:**
+```bash
+npx zuppaclaude uninstall
+```
+
+**🐚 Via Shell:**
+
+**🍎 macOS / 🐧 Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.sh | bash
+```
+
+**🪟 Windows:**
+```powershell
+irm https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/uninstall.ps1 | iex
+```
+
+### 📁 File Locations
+
+| File | 🍎🐧 macOS/Linux | 🪟 Windows |
+|------|------------------|------------|
+| ⚡ SuperClaude | `~/.claude/commands/sc/` | `%USERPROFILE%\.claude\commands\sc\` |
+| 📝 Configuration | `~/.claude/CLAUDE.md` | `%USERPROFILE%\.claude\CLAUDE.md` |
+| 🌐 Claude-Z | `~/.local/bin/claude-z` | `%USERPROFILE%\.local\bin\claude-z.cmd` |
+| 📊 Claude HUD | `~/.local/bin/setup-claude-hud` | `%USERPROFILE%\.local\bin\setup-claude-hud.cmd` |
+| 🔧 Z.AI Config | `~/.config/zai/` | `%USERPROFILE%\.config\zai\` |
+| ⚙️ Settings | `~/.config/zuppaclaude/` | `%USERPROFILE%\.config\zuppaclaude\` |
+
+### 🔧 Troubleshooting
+
+#### ❌ "specify" command not found
+**🍎🐧 macOS/Linux:** Add to `~/.zshrc` or `~/.bashrc`:
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+**🪟 Windows:** Restart PowerShell or add `%USERPROFILE%\.local\bin` to PATH.
+
+#### ❌ SuperClaude commands not showing
+🔄 Restart Claude Code completely (quit and reopen).
+
+#### ❌ Execution Policy Error (Windows)
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+```
+
+---
+
+## 🙏 Credits
+
+| Project | Author |
+|---------|--------|
+| [Claude Code](https://claude.ai/code) | Anthropic |
+| [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) | SuperClaude Org |
+| [Spec Kit](https://github.com/github/spec-kit) | GitHub |
+| [z.ai](https://z.ai) | Z.AI |
+| [Claude HUD](https://github.com/jarrodwatts/claude-hud) | Jarrod Watts |
+
+## 📄 License
+
+MIT

package/bin/zuppaclaude.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+/**
+ * ZuppaClaude CLI
+ * Claude Code power-up installer
+ */
+
+const { Installer } = require('../lib/installer');
+const { Settings } = require('../lib/settings');
+const { Logger } = require('../lib/utils/logger');
+
+const args = process.argv.slice(2);
+const command = args[0] || 'install';
+
+async function main() {
+  const logger = new Logger();
+
+  logger.banner();
+
+  try {
+    switch (command) {
+      case 'install':
+      case 'i':
+        const installer = new Installer();
+        await installer.run();
+        break;
+
+      case 'uninstall':
+      case 'remove':
+      case 'u':
+        const { Uninstaller } = require('../lib/uninstaller');
+        const uninstaller = new Uninstaller();
+        await uninstaller.run();
+        break;
+
+      case 'settings':
+      case 's':
+        const settings = new Settings();
+        const subCommand = args[1] || 'show';
+        const filePath = args[2];
+
+        switch (subCommand) {
+          case 'show':
+            settings.show();
+            break;
+          case 'export':
+            if (!filePath) {
+              logger.error('Please specify export file path');
+              logger.info('Usage: zuppaclaude settings export <file>');
+              process.exit(1);
+            }
+            settings.export(filePath);
+            break;
+          case 'import':
+            if (!filePath) {
+              logger.error('Please specify import file path');
+              logger.info('Usage: zuppaclaude settings import <file>');
+              process.exit(1);
+            }
+            settings.import(filePath);
+            break;
+          case 'reset':
+            await settings.reset();
+            break;
+          case 'path':
+            console.log(settings.filePath);
+            break;
+          default:
+            logger.error(`Unknown settings command: ${subCommand}`);
+            showSettingsHelp();
+        }
+        break;
+
+      case 'version':
+      case 'v':
+      case '-v':
+      case '--version':
+        const pkg = require('../package.json');
+        console.log(`zuppaclaude v${pkg.version}`);
+        break;
+
+      case 'help':
+      case 'h':
+      case '-h':
+      case '--help':
+        showHelp();
+        break;
+
+      default:
+        logger.error(`Unknown command: ${command}`);
+        showHelp();
+        process.exit(1);
+    }
+  } catch (error) {
+    logger.error(`Error: ${error.message}`);
+    if (process.env.DEBUG) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
+function showHelp() {
+  console.log(`
+Usage: zuppaclaude [command] [options]
+
+Commands:
+  install, i          Install ZuppaClaude components (default)
+  uninstall, u        Uninstall ZuppaClaude components
+  settings, s         Manage settings
+  version, v          Show version
+  help, h             Show this help
+
+Settings Commands:
+  settings show       Display current settings
+  settings export     Export settings to file
+  settings import     Import settings from file
+  settings reset      Reset settings to default
+  settings path       Show settings file path
+
+Examples:
+  npx zuppaclaude                    # Install
+  npx zuppaclaude install            # Install
+  npx zuppaclaude uninstall          # Uninstall
+  npx zuppaclaude settings show      # View settings
+  npx zuppaclaude settings export ~/backup.json
+`);
+}
+
+function showSettingsHelp() {
+  console.log(`
+Settings Commands:
+  show       Display current settings
+  export     Export settings to file
+  import     Import settings from file
+  reset      Reset settings to default
+  path       Show settings file path
+
+Examples:
+  zuppaclaude settings show
+  zuppaclaude settings export ~/backup.json
+  zuppaclaude settings import ~/backup.json
+  zuppaclaude settings reset
+`);
+}
+
+main();