Part of the GUAP Ecosystem • General Utilities & Application Protocols
Dual Pure-Rust Win32 (WinSafe) & Iced 0.14 Consoles • Zero Electron / WebView2 / .NET

Native Win32 & Cross-Platform Robocopy Suite & MCP Server

A 100% pure-Rust desktop GUI wrapper, bidirectional command & .rcj job orchestrator, live telemetry runner, offline audit reporter, CLI, and 9-tool Model Context Protocol (MCP) server for Microsoft Robocopy — developed by Andrew Paolucci. Ships both zero-GPU native Win32 (WinSafe 0.0.29) for Windows Server RDP and cross-platform Iced 0.14 for Linux, macOS, and Windows.

Download v0.1.0 Binaries ↓ Inspect Dual-GUI Workbench Explore 9-Tool MCP Server → Read Project Wiki ↗
Dual GUIs
WinSafe Win32 + Iced 0.14
2.78 MiB
Zero-GPU Win32 Release Binary
8 Presets
Complete Win 10/11 Switch Model
9 MCP Tools
stdio JSON-RPC + Safety Guard
Two First-Class Pure-Rust Consoles

Zero-GPU Native Win32 & Cross-Platform Iced 0.14

Both GUIs share the exact same robocopy2rust-core validation, runner, and audit report libraries — zero Electron, zero WebView2, zero Node.js, and zero .NET Framework dependencies.

WinSafe 0.0.29 ~2.78 MiB Binary Windows Default GUI

robocopy2rust-win32.exe

Authentic native Win32 Common Controls built directly on real HWND handles — designed specifically for Windows desktops, elevated Administrator sessions, Hyper-V/VMware consoles, and Windows Server over RDP where GPU drivers may be absent.

  • ComCtl v6 + Per-Monitor DPI v2: Embedded app manifests for crisp scaling across MSVC and MinGW toolchains.
  • Zero-GPU GDI Rendering: Zero OpenGL/DirectX shader crashes in headless VMs or remote desktop sessions.
  • Vista+ COM Dialogs: Uses native IFileOpenDialog & IFileSaveDialog plus arboard clipboard copy.
  • 7 Native TabPages & Relay: mpsc worker stream marshaled safely onto the UI loop via run_ui_thread, with native OS MessageBox destructive prompts.
Iced 0.14 (Elm MVU) ~10.72 MiB Binary Linux / macOS / Windows

robocopy2rust-iced

Modern retained-mode desktop workstation built on Elm Model-View-Update architecture, bringing full Windows job design, .rcj import/export, switch diagnostics, and log auditing identically to Linux, macOS, and Windows (robocopy2rust gui --iced).

  • Automatic Software Fallback: Hardware-accelerated wgpu with built-in tiny-skia CPU rasterizer (ICED_BACKEND=tiny-skia).
  • Light & Dark Themes: One-click Theme::Light / Theme::Dark switcher in the top toolbar with near-0% idle CPU.
  • 8 Workspace Tabs + 6 Modals: Sidebar presets & live error/warning counts, 50,000-line log ring buffer, and modal overlays for imports, Task Scheduler, and exit codes.
  • Cross-OS Job Authoring: Author, validate, import UTF-8/UTF-16 .rcj files, and inspect archived logs from any OS.
Deterministic Core Architecture

Complete Microsoft Robocopy Control & Safety

Eliminating brittle batch scripts, 1,000,000-retry hangs, and backslash quoting corruption through formal schema modeling.

⚙

Full Windows 10/11 Switch Model

Covers every Copy, Selection, Throttle, Retry, Logging, and Job switch including modern Windows 10/11 flags: /IoMaxSize, /IoRate, /Threshold, /LFSM, /COMPRESS, /NOCLONE, /SPARSE:Y|N, /COPY:[DATXSOU], and /DCOPY:[DATEX].

🛡

CommandLineToArgvW & Safe Defaults

Applies sensible defaults (/E /MT:8 /R:3 /W:5 /ETA) instead of raw Robocopy's 1,000,000-retry hang, and automatically escapes trailing backslashes ("C:\Data Src\\") so Windows never misparses quoted paths.

🔄

Bidirectional CLI & .rcj Parser

Paste any existing robocopy ... command line or load UTF-8, UTF-8 BOM, and UTF-16LE/BE .rcj job files directly into structured GUI fields or normalized JSON with conflict warnings.

⚠

16 Validation Rules & Guardrails

Pre-flight diagnostics catch incompatible flags (/MT + /IPG, /MT + /EFSRAW, /MT + /LFSM) and destination-inside-source recursion, while blocking /MIR, /PURGE, /MOVE, and /MOV without explicit confirmation.

📊

Live \r Telemetry & Air-Gapped Reports

Executes with CREATE_NO_WINDOW streaming live % progress, filterable diff entries (New File, Newer, *EXTRA File, FAILED), SHA-256 log hashes, and offline HTML/JSON/Markdown bundles.

📅

Profiles, Batch Queue & Exports

Maintains persistent profiles.json and a 200-entry run history, multi-job sequential batch execution with Stop on Error (exit >= 8), and one-click exports to .rcj, .bat, .ps1, and schtasks.

Workflow Comparison

robocopy2rust vs. Legacy Workflows

Comparing stability, quoting safety, cross-platform reach, and auditability across Windows transfer workflows.

Capability / Metric robocopy2rust (WinSafe + Iced) Raw robocopy.exe Legacy GUIs PowerShell Scripts
Windows Native & RDP Stability WIN Authentic Win32 (winsafe) — zero GPU/OpenGL crash risk Console only .NET Framework / WinForms None
Cross-Platform Parity WIN Unified Iced 0.14 UI on Linux, macOS, Windows Windows only Windows only PowerShell only
Win 10/11 Switch Coverage WIN Full (/IoMaxSize, /IoRate, /LFSM, /COMPRESS) Manual flag recall Partial / dated switches Manual concatenation
Quoting & Trailing \ Safety WIN Automatic CommandLineToArgvW backslash doubling Breaks on "C:\dir\" Basic quoting Error-prone escaping
Bidirectional .rcj & CLI WIN Paste CLI or import UTF-8/UTF-16 .rcj into GUI Separate /JOB: syntax Export only or partial None
Destructive Safety Guards WIN Mandatory /L preview & confirm gate across UI/CLI/MCP Immediate execution Basic prompt Manual -WhatIf
Live Telemetry & Reports WIN \r progress, diff table, offline HTML/JSON/MD + SHA-256 Plain text scroll Raw text box Plain log file
AI Agent Integration WIN Native stdio MCP Server (9 structured tools) None None None
Interactive Console Walkthrough

Dual-GUI & Orchestration Workbench

Explore how robocopy2rust-win32, robocopy2rust-iced, the CLI orchestrator, and robocopy2rust-mcp operate end-to-end.

Zero-GPU Native Win32 7-Tab Console (robocopy2rust-win32.exe)

Built directly with WinSafe 0.0.29 on ComCtl v6 & Per-Monitor DPI v2 — zero GPU shader dependencies for elevated Admin and Server RDP sessions.

robocopy2rust-win32.exe — 7 Native TabPage Views 2.78 MiB • Zero GPU / RDP Safe
[Menu: &File | &Job | &Execution | &Help] [Source: "C:\Data Src\\"] [Dest: "D:\Backup"] [<--> Swap] +---------------------------------------------------------------------------------------------------+ | [1. Designer & Diagnostics] [2. Copy & Transfer] [3. File Selection] [4. Throttle & Retry] | | [5. Logging & Jobs] [6. Live Console & Diff] [7. Batch & History] | +---------------------------------------------------------------------------------------------------+ | Preset: [Safe Incremental Backup (safe-backup)] • Switches: /E /MT:8 /XJ /R:3 /W:5 /ETA | | Command Preview: robocopy "C:\Data Src\\" "D:\Backup" /E /MT:8 /XJ /R:3 /W:5 /ETA | | Validation ListView: [OK] 0 Errors, 0 Warnings • Trailing backslash normalized for Win32 argvW | | Worker Relay: mpsc::Receiver -> wnd.run_ui_thread(...) • Destructive Guard: Native OS MessageBox | +---------------------------------------------------------------------------------------------------+

Cross-Platform Iced 0.14 Workstation (robocopy2rust gui --iced)

Elm MVU UI running across Linux, macOS, and Windows with hardware wgpu and automatic tiny-skia software rendering fallback.

robocopy2rust-iced — 1360x840 Elm MVU Workbench wgpu + tiny-skia fallback • Dark/Light
[Top Toolbar] Source [...] | Dest [...] | [Swap] | [Dry-Run (/L)] | [Execute] | [Queue +] | [Theme] +-------------------------+-------------------------------------------------------------------------+ | SIDEBAR (255 px) | ACTIVE WORKSPACE: Live Console & Diff (Idle poll: 0% CPU) | | > Job Designer | ----------------------------------------------------------------------- | | > Copy & Transfer | Modals (ActiveModal): | | > File Selection | - ConfirmDestructive (blocks /MIR /PURGE /MOVE /MOV + 1-click /L) | | > Throttle & Retry | - ImportCommand (paste raw CLI or .rcj directly into GUI state) | | > Logging & Jobs | - SaveProfile (writes %APPDATA%\robocopy2rust\profiles.json) | | > Live Console & Diff | - TaskScheduler (schtasks /Create Daily/Weekly/Hourly/OnLogon) | | > Batch Queue | - ExitCodeReference (live 0..=16 bitmask breakdown tester) | | > History & Reports | | +-------------------------+-------------------------------------------------------------------------+

Non-Destructive /L Simulation & SHA-256 Report (robocopy2rust dry-run)

Forces /L /FP /BYTES, parses every file action, decodes the 0–16 bitmask exit code, and writes an air-gapped HTML report.

robocopy2rust dry-run — List-Only Preview ZERO BYTES WRITTEN
PS> robocopy2rust dry-run --source "C:\Data Src" --dest "D:\Backup" --report preview.html [PREFLIGHT] 0 Errors, 0 Warnings • Enforcing /L /FP /BYTES dry-run simulation [STREAM] 100% New File 14,820,416 C:\Data Src\Q4_Archive\financial_ledger.xlsx [STREAM] 100% Newer 1,042,900 C:\Data Src\Config\routing_policy.toml [STREAM] *EXTRA File 524,288 D:\Backup\stale_cache.tmp [SUMMARY] Exit Code: 3 (0x03 = COPIED | EXTRA_DETECTED) -> Status: SUCCESS (< 8) [CUSTODY] Log SHA-256: 8f4e2a91c0d73e55...b918c2d0f4e3 [REPORT] Standalone air-gapped report written to: .\preview.html

Script Export & Bidirectional Parser (robocopy2rust build / parse)

Generates repeatable Windows .rcj jobs, .bat, .ps1, and elevated schtasks registrations cleanly.

robocopy2rust build — .rcj / .ps1 / schtasks Export UTF-8 / UTF-16LE CODEC
PS> robocopy2rust build --source "C:\Data Src" --dest "D:\Backup" --preset enterprise-migration --export-rcj job.rcj --export-ps1 backup.ps1 --export-schtasks [COMMAND] robocopy "C:\Data Src" "D:\Backup" /E /ZB /COPYALL /DCOPY:DAT /MT:16 /XJ /R:5 /W:10 /FP /TS [EXPORT] Wrote Robocopy Job file: job.rcj [EXPORT] Wrote PowerShell script (decodes 0-7 exit bitmask): backup.ps1 [SCHTASKS] schtasks /Create /TN "Robocopy2Rust_Job" /TR "powershell.exe -ExecutionPolicy Bypass -File \"backup.ps1\"" /SC DAILY /ST 02:00 /RL HIGHEST

Model Context Protocol Safety Refusal Gate (robocopy2rust-mcp)

Destructive runs triggered by AI agents without explicit human confirmation are hard-blocked at the protocol boundary.

robocopy2rust-mcp — JSON-RPC 2.0 (protocol 2024-11-05) SAFETY REFUSAL ACTIVE
Client -> {"jsonrpc":"2.0","method":"tools/call","params":{"name":"robocopy2rust_run","arguments":{"preset":"exact-mirror","source":"C:\\Src","destination":"D:\\Dst"}},"id":4} Server <- { "jsonrpc": "2.0", "result": { "isError": true, "content": [{ "type": "text", "text": "SAFETY REFUSAL: Job includes destructive flag(s) (/MIR, /PURGE). Re-run with robocopy2rust_dry_run first or set confirm_destructive=true." }] }, "id": 4 }
Modular Pure-Rust Workspace

The 7 Workspace Crates

Clean crate boundaries built on Rust 2024 Edition (MSRV 1.88) with 23 automated unit and live-Robocopy integration tests.

robocopy2rust-coreCore Schema

RobocopyJob model covering all Win 10/11 switches, CommandLineToArgvW quoting, bidirectional CLI & UTF-8/16 .rcj parser, 16 validation diagnostics, 0–16 bitmask decoder, 8 presets, .bat/.ps1/schtasks exporters, and profiles.json store.

serderegexdirs
robocopy2rust-runnerStreaming Engine

Probes host OS & robocopy.exe, executes transfers cleanly with CREATE_NO_WINDOW, parses live \r percentages and Dirs/Files/Bytes summaries, enforces CancelToken kills, and hashes logs with SHA-256.

sha2ctrlcmpsc
robocopy2rust-reportAudit Bundles

Generates zero-CDN standalone offline HTML (with interactive action filters and theme toggle), structured JSON, and Markdown audit reports from live runs or imported legacy Robocopy logs.

htmlserde_jsonmarkdown
robocopy2rust-mcpAI Bridge

Model Context Protocol JSON-RPC 2.0 stdio server (2024-11-05) and standalone robocopy2rust-mcp binary exposing 9 structured tools with destructive refusal enforcement.

stdiojson-rpc 2.09 tools
robocopy2rust-cliUnified CLI

Unified CLI binary (robocopy2rust) delivering 11 subcommands (presets, build, parse, decode, dry-run, run, profile, report, env, mcp, gui), two-stage Ctrl+C cancellation, and automatic GUI dispatch.

clap 4.6tracing~3.30 MiB
robocopy2rust-win32Native Win32

Zero-GPU native Win32 Common Controls console via WinSafe 0.0.29 (ComCtl v6, Per-Monitor DPI v2, Vista+ COM dialogs, 7 tabs, native MessageBox) built for Windows desktops & Server RDP.

winsafe 0.0.29zero-gpu~2.78 MiB
robocopy2rust-icedCross-Platform GUI

Cross-platform Elm MVU GUI on Iced 0.14 with wgpu + tiny-skia CPU fallback, Light/Dark themes, 8 workspace tabs, and 6 modal overlays across Linux, macOS, and Windows.

iced 0.14tiny-skiarfd 0.17
Model Context Protocol (2024-11-05)

9-Tool stdio MCP Server for AI Agents

Safe agentic Robocopy orchestration: inspect host binaries, build validated scripts, preview changes with /L dry-runs, and guard destructive flags before execution.

Standard Client Configuration (mcp.json / Smithery Ready)

Register via robocopy2rust mcp or invoke the standalone robocopy2rust-mcp binary directly (diagnostic logs route strictly to stderr so JSON-RPC stdout stays clean):

mcp.json
{
  "mcpServers": {
    "robocopy2rust": {
      "command": "robocopy2rust",
      "args": ["mcp"],
      "env": {
        "RUST_LOG": "warn"
      }
    }
  }
}
MCP Tool Name Key Arguments Behavior & Safety Model
robocopy2rust_environment{}Probes host OS, robocopy.exe path availability, and ProfileStore directory.
robocopy2rust_presets{}Lists all 8 built-in templates with categories, destructive indicators, and full schemas.
robocopy2rust_build_commandjob, preset, source, destination, include_scriptsValidates job parameters and optionally emits .rcj, .bat, .ps1, and schtasks commands.
robocopy2rust_parse_commandcommand | rcj_pathParses a raw CLI string or UTF-8/UTF-16 .rcj file into normalized command text, warnings, and JSON.
robocopy2rust_decode_exit_codecode: intDecodes Robocopy bitmask exit code (0..=16 or cancelled) into severity, flags, and summary.
robocopy2rust_profilesaction, name, job, store_dirPerforms persistent CRUD (list, get, save, delete) on profiles.json.
robocopy2rust_dry_runjob | command | preset, source, destinationExecutes a non-destructive /L simulation after validation and returns parsed counts & SHA-256 log hash.
robocopy2rust_run..., confirm_destructive: boolExecutes live transfer; strictly refuses /MIR, /PURGE, /MOVE, or /MOV unless confirm_destructive: true.
robocopy2rust_reportoutput, format, log_path | jobGenerates standalone offline HTML, JSON, Markdown, or all three audit bundles on disk.
Protocol Specification

Robocopy Exit Code Bitmask Decoder (0–16)

Unlike conventional tools where 1 means failure, Robocopy returns a bitmask where exit codes 0–7 indicate success and 8 or higher indicate errors. Test any exit code live below:

Interactive Bitmask Tester (Select Exit Code)
Exit Code Bitmask Outcome Meaning
00x00SUCCESSNo files copied, no failures; source and destination are already synchronized.
10x01SUCCESSOne or more files were copied successfully (new files added).
20x02SUCCESSExtra files or directories were detected in the destination.
30x01 | 0x02SUCCESSFiles were copied and extra files/directories were detected in destination.
40x04SUCCESSMismatched files or directories were detected.
5–70x01..0x04SUCCESSBitwise combinations of copied, extra, and mismatched file states.
80x08ERRORSome files or directories could not be copied after retries (/R:n).
160x10FATALSerious error: invalid usage, missing path, or access denied (zero files copied).
Interactive CLI Builder

Command-Line Interface Generator

Build safe, normalized robocopy2rust commands across all 11 subcommands and 8 built-in presets.

Generated robocopy2rust Command
robocopy2rust dry-run --source "C:\Data Src" --dest "D:\Backup" --preset safe-backup --report preview.html
Verified Release v0.1.0

Pre-Compiled Standalone Binaries

Self-contained native executables with zero external runtime dependencies. Verified via GitHub Actions CI & Release workflows alongside SHA256SUMS.txt.

Windows (64-Bit)

MSVC
x86_64-pc-windows-msvc

Includes robocopy2rust.exe (~3.30 MiB), robocopy2rust-win32.exe (~2.78 MiB), robocopy2rust-iced.exe (~10.72 MiB), and robocopy2rust-mcp.exe (~2.67 MiB).

Download .ZIP ↓

Linux (64-Bit)

GNU
x86_64-unknown-linux-gnu

Native ELF binaries: robocopy2rust, robocopy2rust-iced (wgpu + tiny-skia), and robocopy2rust-mcp.

Download .TAR.GZ ↓

macOS Apple Silicon

ARM64
aarch64-apple-darwin (M1–M4)

Native Mach-O ARM64 binaries for Apple Silicon Mac workstations (author jobs, .rcj/scripts, and audit logs).

Download .TAR.GZ ↓

macOS Intel (64-Bit)

x86_64
x86_64-apple-darwin

Universal 64-bit Intel Mach-O binaries for Intel Mac systems plus full source build instructions via Rust 1.88+.

Download .TAR.GZ ↓
Download Checksums (SHA256SUMS.txt) ↗
Community & Ecosystem

Contributors & Acknowledgments

The developers, maintainers, and open-source foundations behind robocopy2rust.

Andrew Paolucci (@adpaolucci)

Project creator, systems architect, and lead software developer. Designed the 7-crate workspace, WinSafe/Iced dual-GUI architecture, bidirectional parser, and safety guards.

WinSafe & Iced Rust Ecosystems

Powered by Rodrigo Cesar de Freitas Dias's winsafe for authentic zero-GPU Win32 bindings and Héctor Ramón's iced framework for clean cross-platform Elm MVU rendering.

Open-Source AI Collaboration

Rapid test generation, comprehensive 12-page Project Wiki documentation, and cross-platform CI matrix verification for Windows, Linux, and macOS targets.

Systems Architecture

Part of the GUAP Open-Source Suite

Created by Andrew Paolucci under GUAP (General Utilities & Application Protocols). Dedicated to replacing fragile legacy wrappers and proprietary black boxes with fast, memory-safe, auditable systems software.