Add Windows setup guide
This commit is contained in:
admin
519
WINDOWS-SETUP.md
Normal file
519
WINDOWS-SETUP.md
Normal file
@@ -0,0 +1,519 @@
|
||||
# Windows Cross-Device Sync Guide
|
||||
|
||||
Complete guide for syncing Claude Code agents and skills on Windows machines.
|
||||
|
||||
---
|
||||
|
||||
## 📋 Prerequisites
|
||||
|
||||
### Required Software
|
||||
|
||||
1. **Git for Windows**
|
||||
- Download: https://git-scm.com/download/win
|
||||
- Install with "Git Bash" option enabled
|
||||
- Use default settings during installation
|
||||
|
||||
2. **Claude Code** (if using skills)
|
||||
- Should already be installed
|
||||
- Skills directory: `%USERPROFILE%\.claude\skills`
|
||||
- Agents directory: `%USERPROFILE%\.claude\agents`
|
||||
|
||||
3. **PowerShell or Git Bash**
|
||||
- PowerShell: Built into Windows
|
||||
- Git Bash: Comes with Git for Windows (recommended for commands below)
|
||||
|
||||
---
|
||||
|
||||
## 🤖 Agent Sync on Windows
|
||||
|
||||
### Initial Setup
|
||||
|
||||
Open **Git Bash** (or PowerShell with git installed):
|
||||
|
||||
```bash
|
||||
# Configure git (one-time)
|
||||
git config --global user.name "admin"
|
||||
git config --global user.email "admin@server-ai.local"
|
||||
git config --global init.defaultBranch main
|
||||
|
||||
# Clone agents repository
|
||||
git clone https://admin:MyN3wP%40ssword%21@gitea.pressmess.duckdns.org/admin/claude-agents.git %USERPROFILE%\.claude\agents
|
||||
|
||||
# Or in Git Bash (Unix-style paths)
|
||||
git clone https://admin:MyN3wP%40ssword%21@gitea.pressmess.duckdns.org/admin/claude-agents.git ~/.claude/agents
|
||||
```
|
||||
|
||||
### If You Have Existing Agents
|
||||
|
||||
```bash
|
||||
# Backup first
|
||||
cp -r ~/.claude/agents ~/.claude/agents.backup
|
||||
|
||||
# Initialize git
|
||||
cd ~/.claude/agents
|
||||
git init
|
||||
git checkout -b main
|
||||
|
||||
# Commit existing agents
|
||||
git add .
|
||||
git commit -m "Add existing agents from Windows PC"
|
||||
|
||||
# Connect to Gitea
|
||||
git remote add origin https://admin:MyN3wP%40ssword%21@gitea.pressmess.duckdns.org/admin/claude-agents.git
|
||||
|
||||
# Merge with remote
|
||||
git pull origin main --allow-unrelated-histories
|
||||
|
||||
# Push your agents
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### Daily Sync (Git Bash)
|
||||
|
||||
```bash
|
||||
# Pull updates
|
||||
cd ~/.claude/agents
|
||||
git pull origin main
|
||||
|
||||
# Push changes
|
||||
cd ~/.claude/agents
|
||||
git add .
|
||||
git commit -m "Update agents from Windows"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### Daily Sync (PowerShell)
|
||||
|
||||
```powershell
|
||||
# Pull updates
|
||||
cd $env:USERPROFILE\.claude\agents
|
||||
git pull origin main
|
||||
|
||||
# Push changes
|
||||
cd $env:USERPROFILE\.claude\agents
|
||||
git add .
|
||||
git commit -m "Update agents from Windows"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Skills Sync on Windows
|
||||
|
||||
### Skillshare Installation on Windows
|
||||
|
||||
**Method 1: Manual Installation (Recommended)**
|
||||
|
||||
1. Download latest release from GitHub:
|
||||
- Go to: https://github.com/runkids/skillshare/releases
|
||||
- Download: `skillshare_<version>_windows_amd64.zip`
|
||||
|
||||
2. Extract and install:
|
||||
```powershell
|
||||
# In PowerShell (as Administrator)
|
||||
Expand-Archive skillshare_<version>_windows_amd64.zip -DestinationPath C:\Program Files\skillshare
|
||||
|
||||
# Add to PATH
|
||||
$env:Path += ";C:\Program Files\skillshare"
|
||||
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::Machine)
|
||||
```
|
||||
|
||||
3. Verify installation:
|
||||
```powershell
|
||||
skillshare version
|
||||
```
|
||||
|
||||
**Method 2: Using Scoop (if you have Scoop installed)**
|
||||
|
||||
```powershell
|
||||
# Install via Scoop
|
||||
scoop bucket add extras
|
||||
scoop install skillshare
|
||||
```
|
||||
|
||||
**Method 3: Using Chocolatey (if available)**
|
||||
|
||||
```powershell
|
||||
# Check if available
|
||||
choco search skillshare
|
||||
|
||||
# If available
|
||||
choco install skillshare
|
||||
```
|
||||
|
||||
### Initialize Skillshare on Windows
|
||||
|
||||
**In Git Bash:**
|
||||
|
||||
```bash
|
||||
# Initialize without prompts (AI-friendly)
|
||||
skillshare init --no-copy --all-targets --git
|
||||
|
||||
# Add git remote
|
||||
cd ~/.config/skillshare/skills
|
||||
git remote add origin https://admin:MyN3wP%40ssword%21@gitea.pressmess.duckdns.org/admin/claude-skills.git
|
||||
|
||||
# Pull skills and sync to Claude Code
|
||||
skillshare pull --remote
|
||||
```
|
||||
|
||||
**In PowerShell:**
|
||||
|
||||
```powershell
|
||||
# Initialize
|
||||
skillshare init --no-copy --all-targets --git
|
||||
|
||||
# Add git remote
|
||||
cd $env:USERPROFILE\.config\skillshare\skills
|
||||
git remote add origin https://admin:MyN3wP%40ssword%21@gitea.pressmess.duckdns.org/admin/claude-skills.git
|
||||
|
||||
# Pull skills
|
||||
skillshare pull --remote
|
||||
```
|
||||
|
||||
### Daily Skills Sync (Windows)
|
||||
|
||||
**Git Bash:**
|
||||
```bash
|
||||
# Pull from Gitea (auto-syncs to Claude Code)
|
||||
skillshare pull --remote
|
||||
|
||||
# Push changes
|
||||
skillshare new my-skill
|
||||
skillshare sync
|
||||
skillshare push -m "Add my-skill from Windows"
|
||||
```
|
||||
|
||||
**PowerShell:**
|
||||
```powershell
|
||||
# Same commands work in PowerShell
|
||||
skillshare pull --remote
|
||||
skillshare push -m "Update from Windows"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Windows-Specific Paths
|
||||
|
||||
### Claude Code Directories
|
||||
|
||||
| Linux/Mac | Windows (Git Bash) | Windows (PowerShell) |
|
||||
|-----------|-------------------|---------------------|
|
||||
| `~/.claude/agents` | `~/.claude/agents` | `$env:USERPROFILE\.claude\agents` |
|
||||
| `~/.claude/skills` | `~/.claude/skills` | `$env:USERPROFILE\.claude\skills` |
|
||||
| `~/.config/skillshare/skills` | `~/.config/skillshare/skills` | `$env:USERPROFILE\.config\skillshare\skills` |
|
||||
|
||||
### Typical Windows Paths
|
||||
|
||||
- **Agents**: `C:\Users\YourName\.claude\agents`
|
||||
- **Skills (Claude)**: `C:\Users\YourName\.claude\skills`
|
||||
- **Skills (Source)**: `C:\Users\YourName\.config\skillshare\skills`
|
||||
|
||||
---
|
||||
|
||||
## 🖥️ Windows Batch Scripts
|
||||
|
||||
### sync-agents.bat
|
||||
|
||||
Create `sync-agents.bat` in `%USERPROFILE%\scripts\`:
|
||||
|
||||
```batch
|
||||
@echo off
|
||||
echo Syncing Claude agents...
|
||||
cd %USERPROFILE%\.claude\agents
|
||||
git pull origin main
|
||||
if %ERRORLEVEL% EQU 0 (
|
||||
echo.
|
||||
echo ✓ Agents synced successfully!
|
||||
echo.
|
||||
echo Current agents:
|
||||
dir /b *.md
|
||||
) else (
|
||||
echo.
|
||||
echo ✗ Sync failed!
|
||||
)
|
||||
pause
|
||||
```
|
||||
|
||||
### sync-skills.bat
|
||||
|
||||
Create `sync-skills.bat` in `%USERPROFILE%\scripts\`:
|
||||
|
||||
```batch
|
||||
@echo off
|
||||
echo Syncing Claude skills...
|
||||
skillshare pull --remote
|
||||
if %ERRORLEVEL% EQU 0 (
|
||||
echo.
|
||||
echo ✓ Skills synced successfully!
|
||||
skillshare status
|
||||
) else (
|
||||
echo.
|
||||
echo ✗ Sync failed!
|
||||
)
|
||||
pause
|
||||
```
|
||||
|
||||
### Usage
|
||||
|
||||
Double-click the `.bat` files or run from Command Prompt:
|
||||
```cmd
|
||||
%USERPROFILE%\scripts\sync-agents.bat
|
||||
%USERPROFILE%\scripts\sync-skills.bat
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 PowerShell Scripts (Better Alternative)
|
||||
|
||||
### sync-agents.ps1
|
||||
|
||||
Create `sync-agents.ps1` in `%USERPROFILE%\Documents\WindowsPowerShell\Scripts\`:
|
||||
|
||||
```powershell
|
||||
# Sync Claude agents from Gitea
|
||||
$agentsPath = "$env:USERPROFILE\.claude\agents"
|
||||
|
||||
Write-Host "🔄 Syncing Claude agents..." -ForegroundColor Cyan
|
||||
Set-Location $agentsPath
|
||||
|
||||
try {
|
||||
git pull origin main
|
||||
Write-Host "`n✅ Agents synced successfully!`n" -ForegroundColor Green
|
||||
|
||||
Write-Host "📊 Current agents:" -ForegroundColor Cyan
|
||||
Get-ChildItem -Filter *.md | ForEach-Object {
|
||||
Write-Host " - $($_.BaseName)" -ForegroundColor White
|
||||
}
|
||||
} catch {
|
||||
Write-Host "`n❌ Sync failed: $_`n" -ForegroundColor Red
|
||||
}
|
||||
|
||||
Read-Host "`nPress Enter to continue"
|
||||
```
|
||||
|
||||
### sync-skills.ps1
|
||||
|
||||
Create `sync-skills.ps1`:
|
||||
|
||||
```powershell
|
||||
# Sync Claude skills via Skillshare
|
||||
Write-Host "🔄 Syncing Claude skills..." -ForegroundColor Cyan
|
||||
|
||||
try {
|
||||
skillshare pull --remote
|
||||
Write-Host "`n✅ Skills synced successfully!`n" -ForegroundColor Green
|
||||
skillshare status
|
||||
} catch {
|
||||
Write-Host "`n❌ Sync failed: $_`n" -ForegroundColor Red
|
||||
}
|
||||
|
||||
Read-Host "`nPress Enter to continue"
|
||||
```
|
||||
|
||||
### Enable PowerShell Scripts (One-Time)
|
||||
|
||||
```powershell
|
||||
# Run PowerShell as Administrator
|
||||
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||
```
|
||||
|
||||
### Create PowerShell Aliases
|
||||
|
||||
Add to your PowerShell profile:
|
||||
|
||||
```powershell
|
||||
# Edit profile
|
||||
notepad $PROFILE
|
||||
|
||||
# Add these lines:
|
||||
function Sync-Agents {
|
||||
Set-Location "$env:USERPROFILE\.claude\agents"
|
||||
git pull origin main
|
||||
}
|
||||
|
||||
function Sync-Skills {
|
||||
skillshare pull --remote
|
||||
}
|
||||
|
||||
function Push-Agents {
|
||||
param([string]$message = "Update agents from Windows")
|
||||
Set-Location "$env:USERPROFILE\.claude\agents"
|
||||
git add .
|
||||
git commit -m $message
|
||||
git push origin main
|
||||
}
|
||||
|
||||
function Push-Skills {
|
||||
param([string]$message = "Update skills from Windows")
|
||||
skillshare sync
|
||||
skillshare push -m $message
|
||||
}
|
||||
|
||||
# Usage:
|
||||
# Sync-Agents
|
||||
# Sync-Skills
|
||||
# Push-Agents -message "Add new agent"
|
||||
# Push-Skills -message "Update helper skill"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔐 Credential Management on Windows
|
||||
|
||||
### Option 1: Git Credential Manager (Recommended)
|
||||
|
||||
Git for Windows includes Credential Manager:
|
||||
|
||||
```bash
|
||||
# Configure credential helper (one-time)
|
||||
git config --global credential.helper manager-core
|
||||
|
||||
# First push/pull will prompt for credentials
|
||||
# Credentials are then stored securely in Windows Credential Manager
|
||||
```
|
||||
|
||||
### Option 2: Store Credentials in URL (Less Secure)
|
||||
|
||||
Already configured in the remote URLs:
|
||||
```bash
|
||||
https://admin:MyN3wP%40ssword%21@gitea.pressmess.duckdns.org/admin/claude-agents.git
|
||||
```
|
||||
|
||||
### Option 3: SSH Keys (Most Secure)
|
||||
|
||||
```bash
|
||||
# Generate SSH key
|
||||
ssh-keygen -t ed25519 -C "admin@windows-pc"
|
||||
|
||||
# Copy public key
|
||||
cat ~/.ssh/id_ed25519.pub
|
||||
|
||||
# Add to Gitea:
|
||||
# 1. Login to Gitea
|
||||
# 2. Settings → SSH Keys → Add Key
|
||||
# 3. Paste public key
|
||||
|
||||
# Update remote to use SSH
|
||||
cd ~/.claude/agents
|
||||
git remote set-url origin git@omv800:admin/claude-agents.git
|
||||
|
||||
cd ~/.config/skillshare/skills
|
||||
git remote set-url origin git@omv800:admin/claude-skills.git
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📱 Windows Task Scheduler (Auto-Sync)
|
||||
|
||||
### Create Scheduled Task for Auto-Pull
|
||||
|
||||
1. Open **Task Scheduler**
|
||||
2. Create Basic Task:
|
||||
- **Name**: Sync Claude Agents
|
||||
- **Trigger**: Daily at startup or login
|
||||
- **Action**: Start a program
|
||||
- **Program**: `C:\Program Files\Git\bin\bash.exe`
|
||||
- **Arguments**: `-c "cd ~/.claude/agents && git pull origin main"`
|
||||
|
||||
3. Repeat for skills:
|
||||
- **Name**: Sync Claude Skills
|
||||
- **Program**: `skillshare.exe`
|
||||
- **Arguments**: `pull --remote`
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Troubleshooting Windows
|
||||
|
||||
### Skillshare Not Found
|
||||
|
||||
```powershell
|
||||
# Check if in PATH
|
||||
$env:Path -split ';' | Select-String skillshare
|
||||
|
||||
# If not found, add manually
|
||||
$env:Path += ";C:\Program Files\skillshare"
|
||||
```
|
||||
|
||||
### Line Ending Issues
|
||||
|
||||
```bash
|
||||
# Configure git to handle line endings
|
||||
git config --global core.autocrlf true
|
||||
```
|
||||
|
||||
### Permission Denied
|
||||
|
||||
```powershell
|
||||
# Run PowerShell as Administrator
|
||||
Start-Process powershell -Verb RunAs
|
||||
```
|
||||
|
||||
### Git Command Not Found in PowerShell
|
||||
|
||||
```powershell
|
||||
# Add Git to PATH
|
||||
$env:Path += ";C:\Program Files\Git\bin"
|
||||
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)
|
||||
```
|
||||
|
||||
### Skillshare Init Hangs
|
||||
|
||||
```bash
|
||||
# Use non-interactive flags
|
||||
skillshare init --no-copy --all-targets --git
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Quick Setup Checklist
|
||||
|
||||
### For Agents:
|
||||
- [ ] Install Git for Windows
|
||||
- [ ] Configure git username/email
|
||||
- [ ] Clone or initialize agents repo
|
||||
- [ ] Test pull/push
|
||||
- [ ] Create sync script (optional)
|
||||
|
||||
### For Skills:
|
||||
- [ ] Install Git for Windows
|
||||
- [ ] Download and install Skillshare binary
|
||||
- [ ] Initialize Skillshare with `--all-targets --git`
|
||||
- [ ] Add git remote
|
||||
- [ ] Test `skillshare pull --remote`
|
||||
- [ ] Create sync script (optional)
|
||||
|
||||
---
|
||||
|
||||
## 📚 Windows Resources
|
||||
|
||||
- **Git for Windows**: https://git-scm.com/download/win
|
||||
- **Skillshare Releases**: https://github.com/runkids/skillshare/releases
|
||||
- **PowerShell Docs**: https://docs.microsoft.com/powershell
|
||||
- **Windows Terminal**: https://aka.ms/terminal (better than CMD)
|
||||
|
||||
---
|
||||
|
||||
## 💡 Best Practices for Windows
|
||||
|
||||
1. **Use Git Bash** for Linux-like commands
|
||||
2. **Use PowerShell** for Windows-native scripting
|
||||
3. **Windows Terminal** for better experience
|
||||
4. **VSCode** as git GUI (optional)
|
||||
5. **Store scripts** in `%USERPROFILE%\scripts\`
|
||||
6. **Add to PATH** for easy access
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Related Documentation
|
||||
|
||||
- **Linux/Mac Guide**: `/home/jon/AGENT-SYNC-GUIDE.md`
|
||||
- **Skills Guide**: `/home/jon/SKILLS-SYNC-GUIDE.md`
|
||||
- **Server Docs**: `/home/jon/SERVER-DOCUMENTATION.md`
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: 2026-01-29
|
||||
**Version**: 1.0
|
||||
**Platform**: Windows 10/11
|
||||
**Tested With**: Git for Windows 2.43+, Skillshare 0.6.20
|
||||
Reference in New Issue
Block a user