Claude Workspace Sync System

Capture Claude Desktop conversations and artifacts into a Git-synchronized workspace accessible across all your devices.

---

The Problem

When working with Claude Desktop:

• Conversations disappear when you close the app
• Artifacts (code, configs, documents) live only in memory
• Switching machines means losing all context
• VS Code doesn't know about your Claude work

Result: You can't maintain workflow continuity across devices.

---

The Solution

A structured Git repository (~/claude-workspace/) that captures:

• Conversations - Saved chat sessions with Claude
• Artifacts - Code, configs, and documents Claude creates
• Projects - Organized project workspaces
• Context - What you're working on, for continuity
• Notes - Quick captures and ideas

Everything syncs via GitHub, accessible from any machine or mobile device.

---

Quick Start

1. Setup on First Machine

# Clone this repository
git clone https://github.com/ludwa6/claude-workspace-sync.git
cd claude-workspace-sync

# Run setup script
chmod +x setup-workspace.sh
./setup-workspace.sh

This creates ~/claude-workspace/ with the complete directory structure.

2. Create Your Workspace Repository

# Create a new repo on GitHub named "claude-workspace"
# Then connect your local workspace:

cd ~/claude-workspace
git remote add origin https://github.com/YOUR_USERNAME/claude-workspace.git
git push -u origin main

3. Setup on Second Machine

# Just clone your workspace
git clone https://github.com/YOUR_USERNAME/claude-workspace.git ~/claude-workspace

Done! Now both machines share the same workspace.

---

Daily Workflow

Start of Day

cd ~/claude-workspace
git pull                      # Get latest from other machine
cat context/current-focus.md  # See where you left off
code .                        # Open in VS Code

During Work with Claude

• Save artifacts as you go (code, configs, etc.)
• Use the claude-save helper script for quick captures
• Update files in VS Code as needed

End of Session

cd ~/claude-workspace
git add .
git commit -m "Session 2024-12-09: what you accomplished"
git push

---

Helper Tools

Quick-Save Script

Install the helper for fast artifact capture:

# Copy to your PATH
cp claude-save ~/bin/
chmod +x ~/bin/claude-save

# Use it
claude-save                   # Interactive mode
claude-save script my-tool.sh # Quick command-line mode

---

What's Included

• GUIDE.md - Complete documentation (workflow, templates, best practices)
• QUICKREF.md - Quick reference for daily commands
• setup-workspace.sh - Automated workspace setup
• claude-save - Helper script for capturing artifacts
• Templates - Conversation and project templates

---

Directory Structure

~/claude-workspace/
├── conversations/         # Saved Claude chat sessions
├── artifacts/            # Generated code, configs, documents
│   ├── scripts/
│   ├── configs/
│   ├── documents/
│   └── webapps/
├── projects/             # Active project workspaces
├── notes/                # Quick notes and ideas  
├── context/              # What you're working on
│   ├── current-focus.md # Current state for continuity
│   └── preferences.md   # Your preferences
└── templates/            # Reusable templates

---

Key Features

✅ Cross-machine sync - Work on any device, pick up where you left off
✅ Version control - Full history of all your Claude work
✅ VS Code integration - Edit artifacts in your preferred IDE
✅ Mobile access - View/edit on iPad/iPhone via Working Copy app
✅ Searchable - Find anything with git grep or VS Code search
✅ Context preservation - Never lose track of what you were doing

---

Documentation

• GUIDE.md - Complete workflow guide
• QUICKREF.md - Quick reference for daily use
• Example Conversation - Template usage

---

Requirements

• Git installed
• GitHub account
• Claude Desktop with MCP setup (see claude-mcp-setup)
• VS Code (recommended)

---

Philosophy

Your work with Claude is valuable knowledge that deserves proper version control and accessibility. Instead of conversations vanishing, they become part of your permanent, searchable knowledge base.

---

Related Repositories

• claude-mcp-setup - MCP configuration docs
• claude-workspace - Your actual workspace (you create this)

---

Support

For issues or questions:

• See GUIDE.md for detailed documentation
• Check QUICKREF.md for common commands
• Review the examples/ directory
• Open an issue in this repository

---

License

MIT - Use however you'd like!