claude-space 2.0.0

package/README.md

@@ -0,0 +1,165 @@
+<div align="center">
+
+<img src="./.meta/Banner.png" alt="Claude Space Banner" width="100%"/>
+
+### 🧠 Visual Claude Code Node-Based Agent Builder
+
+*Build multi-agent systems with a drag-and-drop canvas. </br> 
+Full .claude code folder manager (Skills, Commands, Mcps, Subagents, Hooks ..) .*
+
+<p>
+  <img src="https://img.shields.io/badge/Electron-28-47848f?style=for-the-badge&logo=electron&logoColor=white" alt="Electron"/>
+  <img src="https://img.shields.io/badge/Vue_3-4FC08D?style=for-the-badge&logo=vue.js&logoColor=white" alt="Vue 3"/>
+  <img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript"/>
+  <img src="https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white" alt="Vite"/>
+</p>
+
+<p>
+  <img src="https://img.shields.io/badge/license-MIT-purple?style=flat-square" alt="License"/>
+  <img src="https://img.shields.io/badge/version-1.0.0-purple?style=flat-square" alt="Version"/>
+  <img src="https://img.shields.io/badge/node-%3E%3D18.19.9-green?style=flat-square&logo=node.js" alt="Node"/>
+  <img src="https://img.shields.io/badge/Claude_Agent_SDK-0.1.59-9f7aea?style=flat-square&logo=anthropic" alt="Claude SDK"/>
+</p>
+<img src="./.meta/mainspace.gif" alt="Claude Space gif" width="100%"/>
+---
+</div>
+
+---
+
+## 🎯 A Claude code what?
+
+IDE for building Claude AI agents. Think Blender for agent workflows—visual node graph, real-time testing, export to production config.
+
+<img src="./.meta/claudespace.gif" alt="Claude Space gif" width="100%"/>
+
+**And Why?** 🧐
+
+Because manually editing `.claude` configuration folders is a **nightmare** 😱. 
+Visualizing your agent's brain is just better! 🧠✨ 
+
+---
+
+## ⚡ Quick Start
+
+```bash
+# Clone & run
+git clone https://github.com/FilipeBorges1993/ClaudeSpaceElectron.git
+cd claude-code-workspace
+npm install
+npm run dev
+```
+
+**Requirements:** Node.js ≥18.19.9
+
+---
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────┐
+│         Electron Desktop App            │
+├─────────────────────────────────────────┤
+│  Vue 3 + TypeScript + Vite              │
+│  ┌────────────┐  ┌──────────────────┐   │
+│  │ Node Graph │  │  Chat Interface  │   │
+│  │ (Vue Flow) │  │  (Agent Testing) │   │
+│  └────────────┘  └──────────────────┘   │
+├─────────────────────────────────────────┤
+│  Pinia State Management                 │
+├─────────────────────────────────────────┤
+│  Claude Agent SDK Integration           │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 🧩 Node Types
+
+| Node | Purpose | Example Use |
+|------|---------|-------------|
+| 🤖 **Agent** | Main agent config | System prompt, model selection, permissions |
+| 🛠️ **Skill** | Agent capabilities | Custom tools, API integrations, file ops |
+| 🧠 **Memory** | Persistent state | Conversation history, knowledge base, RAG |
+| ⚙️ **Command** | Command templates | Structured inputs, parameter mapping |
+| 🔌 **MCP** | External tools | Context7 docs, file system, databases |
+| 🪝 **Hook** | Lifecycle events | PreToolUse, PostToolUse, SessionStart |
+| 🎭 **Sub-agent** | Delegated agents | Specialized tasks, different models |
+
+---
+
+
+## 🚀 Development
+
+```bash
+# Dev mode with HMR
+npm run dev
+
+# Type checking
+npm run typecheck        # All
+npm run typecheck:node   # Node/Electron
+npm run typecheck:web    # Vue/Renderer
+
+# Code quality
+npm run lint             # ESLint
+npm run format           # Prettier
+
+# Build (platform-specific)
+npm run build:mac        # macOS (Intel + ARM)
+npm run build:win        # Windows (x64 + ARM)
+npm run build:linux      # Linux AppImage
+```
+---
+
+## 📂 Project Structure
+
+```
+src/
+├── main/                    # Electron main process
+│   └── index.ts            # IPC handlers, window management
+├── preload/                # Context bridge & IPC
+└── renderer/src/           # Vue application
+    ├── components/
+    │   ├── NodeCanvas.vue  # Main workflow editor
+    │   ├── ChatPage.vue    # Agent chat/testing UI
+    │   └── Shared/         # Reusable components
+    ├── stores/             # Pinia state (workspace, canvas, agents)
+    ├── types/              # TS interfaces & types
+    ├── utils/              # Helpers, formatters
+    └── App.vue             # Root component
+```
+
+**Workspace Structure:**
+```
+workspace-folder/
+├── project-1/
+│   ├── agent.json          # Generated agent config
+│   ├── workflow.json       # Visual node graph data
+│   ├── skills/             # Skill implementations
+│   └── memory/             # Memory layer configs
+└── project-2/
+    └── ...
+```
+
+---
+
+## 📜 License
+
+MIT License - See [LICENSE](LICENSE)
+
+---
+
+<div align="center">
+
+<img src="https://img.shields.io/badge/Built_with-💜-purple?style=for-the-badge" alt="Built with love"/>
+
+**ClaudeSpace** by [FB](https://www.linkedin.com/in/filipe-borges-8a4749115/)
+
+*Making AI agent development visual, one node at a time.*
+
+```
+⚡ Electron + Vue + Claude SDK = 🚀
+```
+
+[Report Bug](https://github.com/BorisCorp/claude-code-workspace/issues) • [Request Feature](https://discord.gg/2tr2S7yw)
+
+</div>

package/bin/claude-space

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+
+# ClaudeSpace CLI launcher
+# This script launches the ClaudeSpace Electron application
+
+# Get the real directory where this script is located (resolving symlinks)
+SOURCE="${BASH_SOURCE[0]}"
+while [ -h "$SOURCE" ]; do
+  DIR="$( cd -P "$( dirname "$SOURCE" )" && pwd )"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+SCRIPT_DIR="$( cd -P "$( dirname "$SOURCE" )" && pwd )"
+
+# Parse subcommands
+OPEN_CANVAS=false
+PROJECT_PATH=""
+
+if [ "$1" = "project" ]; then
+    OPEN_CANVAS=true
+    if [ "$2" = "." ]; then
+        PROJECT_PATH="$(pwd)"
+    elif [ -n "$2" ]; then
+        # Resolve to absolute path
+        if [ -d "$2" ]; then
+            PROJECT_PATH="$(cd "$2" && pwd)"
+        else
+            PROJECT_PATH="$2"
+        fi
+    else
+        echo "Error: 'project' subcommand requires a path argument"
+        echo "Usage: claude-space project <path>"
+        exit 1
+    fi
+    # Remove 'project' and path from arguments
+    shift 2
+fi
+
+# Determine the app location based on the platform
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS
+    if [ -d "$SCRIPT_DIR/../app/ClaudeSpace.app" ]; then
+        # NPM package distribution location
+        APP_PATH="$SCRIPT_DIR/../app/ClaudeSpace.app"
+    elif [ -d "$SCRIPT_DIR/../dist-npm/mac-arm64/ClaudeSpace.app" ]; then
+        # Development/local build location
+        APP_PATH="$SCRIPT_DIR/../dist-npm/mac-arm64/ClaudeSpace.app"
+    elif [ -d "$SCRIPT_DIR/../ClaudeSpace.app" ]; then
+        # Alternative location
+        APP_PATH="$SCRIPT_DIR/../ClaudeSpace.app"
+    else
+        echo "Error: ClaudeSpace.app not found"
+        echo "Searched in:"
+        echo "  - $SCRIPT_DIR/../app/ClaudeSpace.app"
+        echo "  - $SCRIPT_DIR/../dist-npm/mac-arm64/ClaudeSpace.app"
+        exit 1
+    fi
+
+    # Build arguments for macOS open command
+    ARGS=()
+    if [ -n "$PROJECT_PATH" ] || [ "$OPEN_CANVAS" = true ]; then
+        ARGS+=("--args")
+    fi
+    if [ -n "$PROJECT_PATH" ]; then
+        ARGS+=("--project-path" "$PROJECT_PATH")
+    fi
+    if [ "$OPEN_CANVAS" = true ]; then
+        ARGS+=("--open-canvas")
+    fi
+
+    # Launch the app
+    # Use -n to force a new instance attempt, which triggers second-instance handler
+    open -n "$APP_PATH" "${ARGS[@]}" "$@"
+
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    # Linux
+    if [ -x "$SCRIPT_DIR/../dist-npm/linux-unpacked/ClaudeSpace" ]; then
+        APP_PATH="$SCRIPT_DIR/../dist-npm/linux-unpacked/ClaudeSpace"
+    elif [ -x "$SCRIPT_DIR/../ClaudeSpace" ]; then
+        APP_PATH="$SCRIPT_DIR/../ClaudeSpace"
+    else
+        echo "Error: ClaudeSpace executable not found"
+        exit 1
+    fi
+
+    # Build arguments for Linux
+    ARGS=()
+    if [ -n "$PROJECT_PATH" ]; then
+        ARGS+=("--project-path" "$PROJECT_PATH")
+    fi
+    if [ "$OPEN_CANVAS" = true ]; then
+        ARGS+=("--open-canvas")
+    fi
+
+    "$APP_PATH" "${ARGS[@]}" "$@"
+
+elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "win32" ]]; then
+    # Windows
+    if [ -f "$SCRIPT_DIR/../dist-npm/win-unpacked/ClaudeSpace.exe" ]; then
+        APP_PATH="$SCRIPT_DIR/../dist-npm/win-unpacked/ClaudeSpace.exe"
+    elif [ -f "$SCRIPT_DIR/../ClaudeSpace.exe" ]; then
+        APP_PATH="$SCRIPT_DIR/../ClaudeSpace.exe"
+    else
+        echo "Error: ClaudeSpace.exe not found"
+        exit 1
+    fi
+
+    # Build arguments for Windows
+    ARGS=()
+    if [ -n "$PROJECT_PATH" ]; then
+        ARGS+=("--project-path" "$PROJECT_PATH")
+    fi
+    if [ "$OPEN_CANVAS" = true ]; then
+        ARGS+=("--open-canvas")
+    fi
+
+    "$APP_PATH" "${ARGS[@]}" "$@"
+
+else
+    echo "Error: Unsupported operating system: $OSTYPE"
+    exit 1
+fi

package/bin/claude-space.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Capture current working directory before changing context
+process.env.CLAUDE_SPACE_CWD = process.cwd();
+
+// Parse arguments
+const args = process.argv.slice(2);
+let projectPath = null;
+
+// Handle flags
+if (args.includes('--help') || args.includes('-h')) {
+  console.log('Usage: claude-space [project-path]');
+  console.log('  project-path: Optional path to project folder to open');
+  console.log('Options:');
+  console.log('  --help, -h: Show this help');
+  console.log('  --version, -v: Show version');
+  process.exit(0);
+}
+
+if (args.includes('--version') || args.includes('-v')) {
+  const pkg = require('../package.json');
+  console.log(`claude-space v${pkg.version}`);
+  process.exit(0);
+}
+
+// Look for project path argument (not starting with --)
+for (const arg of args) {
+  if (!arg.startsWith('--')) {
+    projectPath = path.resolve(arg);
+    if (!fs.existsSync(projectPath)) {
+      console.error(`Error: Project path does not exist: ${projectPath}`);
+      process.exit(1);
+    }
+    break;
+  }
+}
+
+// Find Electron executable
+const electronPath = require('electron');
+const appPath = path.join(__dirname, '..');
+
+// Build Electron arguments
+const electronArgs = [appPath];
+if (projectPath) {
+  electronArgs.push('--project-path', projectPath);
+}
+
+// Spawn Electron
+const electron = spawn(electronPath, electronArgs, {
+  stdio: 'inherit',
+  env: process.env
+});
+
+electron.on('close', (code) => {
+  process.exit(code || 0);
+});