Advanced Session & Data Manager for Development Tools

Version Platform Go License

SurfManager is a modern solution for managing session data of development tools like VS Code, Cursor, Windsurf, and similar applications. Built with Go + Wails + Svelte for blazing fast performance and a beautiful native UI.

Perfect for developers who need to:

• 🔄 Switch between multiple accounts/profiles effortlessly
• 💾 Backup workspace settings before experimenting
• 🚀 Maintain organized development workflows
• 🛡️ Have a safety net for important configurations

• Complete Rewrite - Go + Wails + Svelte (from Python + PyQt6)
• 3x Smaller Binary - ~15MB (from 40+MB)
• 2x Faster Startup - <0.5s (from ~1s)
• Modern UI - JetBrains Mono font, realtime clock, custom modals
• Theme System - 3 beautiful themes with persistence
• Skip Close App - Perform operations without closing target app
• Customizable Backups - Choose exactly what to backup
• Additional Folders - Backup extra directories (e.g., ~/.aws, ~/.ssh)
• Custom App Type - Create apps with only addon folders (no AppData backup)
• Edit App Config - Edit existing app configurations via UI dialog

SurfManager manages app data stored in platform-specific locations:

Step 1: Setup First Account

1. Login to your IDE (VS Code/Cursor/Windsurf)
2. Configure your workspace, install extensions
3. Open SurfManager → Sessions → New Backup
4. Enter session name (e.g., "work-account")

Step 2: Add More Accounts

1. Go to Reset tab → Click Reset on your app
2. Login with different credentials in your IDE
3. Create another backup (e.g., "personal-account")

Step 3: Switch Between Accounts

1. Go to Sessions tab
2. Right-click session → Restore
3. Launch your IDE - you're logged in! 🎉

• Right-click anywhere for context menus
• CTRL+Click rows to select multiple items
• Enable "Skip Close App" if you want to backup while app is running
• Use descriptive names like "work-main", "personal-dev"

Windows User Isolation Sessions are tied to the Windows user account. You cannot transfer backups between different Windows users due to encryption.

• ✅ Switch accounts on the same Windows user
• ❌ Copy backups to another Windows user
• ✅ Each Windows user creates their own backups

1. Visit Releases Page
2. Download for your platform:
   • Windows: SurfManager-windows-amd64.exe
   • macOS: SurfManager-darwin-amd64.zip or SurfManager-darwin-arm64.zip (extract and run .app)
   • Linux: SurfManager-linux-amd64
3. Run directly - no installation required!

• Go 1.22+ - Download
• Node.js 18+ - Download
• Wails CLI - Install with: go install github.com/wailsapp/wails/v2/cmd/wails@latest

# Install prerequisites
# 1. Install Go from https://golang.org/dl/
# 2. Install Node.js from https://nodejs.org/
# 3. Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Clone and build
git clone https://github.com/risunCode/SurfManager.git
cd SurfManager
cd frontend && npm install && cd ..
# Development mode
wails dev
# Build for production
wails build
# Output: build/bin/SurfManager.exe

# Install prerequisites
# Using Homebrew:
brew install go node
# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Install Xcode Command Line Tools (required for CGO)
xcode-select --install
# Clone and build
git clone https://github.com/risunCode/SurfManager.git
cd SurfManager
cd frontend && npm install && cd ..
# Development mode
wails dev
# Build for production
wails build
# Output: build/bin/SurfManager.app

# Install prerequisites
sudo apt update
sudo apt install -y golang nodejs npm build-essential libgtk-3-dev libwebkit2gtk-4.0-dev
# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Add Go bin to PATH (add to ~/.bashrc for persistence)
export PATH=$PATH:$(go env GOPATH)/bin
# Clone and build
git clone https://github.com/risunCode/SurfManager.git
cd SurfManager
cd frontend && npm install && cd ..
# Development mode
wails dev
# Build for production
wails build
# Output: build/bin/SurfManager

# Install prerequisites
sudo dnf install -y golang nodejs npm gcc gtk3-devel webkit2gtk3-devel
# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Add Go bin to PATH
export PATH=$PATH:$(go env GOPATH)/bin
# Clone and build (same as Ubuntu)
git clone https://github.com/risunCode/SurfManager.git
cd SurfManager
cd frontend && npm install && cd ..
wails build

# Install prerequisites
sudo pacman -S go nodejs npm base-devel gtk3 webkit2gtk
# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Add Go bin to PATH
export PATH=$PATH:$(go env GOPATH)/bin
# Clone and build
git clone https://github.com/risunCode/SurfManager.git
cd SurfManager
cd frontend && npm install && cd ..
wails build

wails doctor

This will check if all dependencies are installed correctly.

The easiest way to build for all platforms is using GitHub Actions. No need to install anything locally!

1. Fork the repository

   • Go to github.com/risunCode/SurfManager
   • Click "Fork" button (top right)

2. Enable GitHub Actions

   • Go to your forked repo → "Actions" tab
   • Click "I understand my workflows, go ahead and enable them"

3. Run the build

   • Go to "Actions" → "Build SurfManager"
   • Click "Run workflow" dropdown
   • Select platform:
     • all - Build for Windows, Linux, macOS (Intel & Apple Silicon)
     • windows-amd64 - Windows 64-bit only
     • linux-amd64 - Linux 64-bit only
     • macos-amd64 - macOS Intel only
     • macos-arm64 - macOS Apple Silicon only
   • Click "Run workflow"

4. Download artifacts

   • Wait for build to complete (~5-10 minutes)
   • Click on the completed workflow run
   • Download artifacts from the bottom of the page

To automatically create a GitHub Release with all binaries:

# Tag your version
git tag v2.0.0
git push origin v2.0.0

This will:

• Build for all 4 platforms automatically
• Create a GitHub Release
• Attach all binaries to the release

We need your help! SurfManager is primarily developed and tested on Windows. We need contributors to help with:

• Test app data path detection (~/.config, ~/.local/share)
• Test VSCode/Cursor data locations
• Verify file dialogs work correctly
• Test process detection and termination
• Package for different distributions (AppImage, Flatpak, Snap)

• Test app data path detection (~/Library/Application Support)
• Test VSCode/Cursor data locations
• Verify .app bundle selection works
• Test process detection and termination
• Code signing and notarization

1. Fork the repository
2. Test on your Linux/macOS machine
3. Report issues with detailed logs
4. Submit PRs for fixes

Even just testing and reporting issues helps a lot! 🙏

We welcome contributions! Whether it's bug reports, feature suggestions, or code contributions.

git checkout -b feature/awesome-feature
git commit -m 'Add awesome feature'
git push origin feature/awesome-feature
# Open a Pull Request

SurfManager is open-source under the MIT License.

Built with ❤️ by risunCode

Technologies: Go, Wails v2, Svelte, TailwindCSS, Lucide Icons