Installation & Setup

npm -i -g claude-space

# Run ClaudeSpace
claude-space

# or open in the porject canvas directly (where the .claude folder is located)
claude-space project .

# Clone the repository
git clone https://github.com/FilipeBorges1993/ClaudeSpaceElectron.git
cd ClaudeSpaceElectron

# Install dependencies
npm install

# Run ClaudeSpace
npm run dev

# Install Claude CLI if not already installed
npm install -g @anthropic-ai/claude-cli

# Authenticate
claude auth login

# Development mode with hot reload
npm run dev

# Type checking
npm run typecheck           # All
npm run typecheck:node      # Main process
npm run typecheck:web       # Renderer process

# Code quality
npm run lint                # ESLint check
npm run lint:fix            # Auto-fix issues
npm run format              # Prettier format

# Build for production
npm run build:mac           # macOS
npm run build:win           # Windows
npm run build:linux         # Linux
npm run build:all           # All platforms

# Clean build artifacts
rm -rf dist node_modules
npm install

┌─────────────────────────────────────┐
│    Electron Main Process (Node.js)  │
│  - IPC handlers (80+ handlers)      │
│  - Agent session management         │
│  - File I/O operations              │
│  - Claude SDK integration           │
└──────────────┬──────────────────────┘
               │ IPC Bridge
┌──────────────▼──────────────────────┐
│     Vue 3 Renderer (Frontend)        │
│  - NodeCanvas (Vue Flow)            │
│  - ChatPage (testing UI)            │
│  - Settings & configuration         │
│  - Pinia state management           │
└─────────────────────────────────────┘

src/
├── main/           # Electron main process (Node.js)
├── preload/        # Context bridge & IPC
└── renderer/       # Vue 3 application (UI)