CC-Workshop: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What This Is

CC Workshop is a macOS desktop app for managing Claude Code configurations (Skills, MCP Servers, CLAUDE.md files, Rules). Built with Tauri 2 (Rust backend) + React/TypeScript frontend. It imports configs from ~/.claude/ and ~/.claude.json, organizes them with categories/tags, bundles them into Scenes, and deploys Scenes to projects via symlinks and .mcp.json files.

Commands

# Development (runs Vite frontend + Rust backend concurrently)
npm run tauri dev

# Production build (outputs .app to src-tauri/target/release/bundle/macos/)
npm run tauri build

# Frontend-only dev server (no Tauri IPC — limited functionality)
npm run dev

# Tests
npm test                          # Frontend (vitest)
npm run test:watch                # Frontend watch mode
cd src-tauri && cargo test        # Rust backend
npm run test:all                  # Both frontend + backend

# Lint
npx eslint src/                   # ESLint (flat config)

Architecture

IPC Boundary

Frontend calls Rust via safeInvoke() (src/utils/tauri.ts), which wraps Tauri's invoke() with environment detection. All backend commands are registered in src-tauri/src/lib.rs via tauri::generate_handler![]. The Rust command modules live in src-tauri/src/commands/ — one file per domain (skills, mcps, config, data, etc.).

Types must stay in sync across the boundary:

• Rust: src-tauri/src/types.rs (all types use #[serde(rename_all = "camelCase")])
• TypeScript: src/types/index.ts, src/types/claudeMd.ts, src/types/rule.ts, src/types/plugin.ts, src/types/trash.ts

State Management

Each domain has its own Zustand store (src/stores/). Stores call safeInvoke() for persistence and apply optimistic updates. The appStore handles categories, tags, and cross-cutting UI state; domain stores (skillsStore, mcpsStore, scenesStore, etc.) handle their respective entities.