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.
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.
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&IFileSaveDialogplusarboardclipboard copy. - 7 Native TabPages & Relay:
mpscworker stream marshaled safely onto the UI loop viarun_ui_thread, with native OSMessageBoxdestructive prompts.
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
wgpuwith built-intiny-skiaCPU rasterizer (ICED_BACKEND=tiny-skia). - Light & Dark Themes: One-click
Theme::Light/Theme::Darkswitcher 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
.rcjfiles, and inspect archived logs from any OS.
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.
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 |
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.
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.
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.
Script Export & Bidirectional Parser (robocopy2rust build / parse)
Generates repeatable Windows .rcj jobs, .bat, .ps1, and elevated schtasks registrations cleanly.
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.
The 7 Workspace Crates
Clean crate boundaries built on Rust 2024 Edition (MSRV 1.88) with 23 automated unit and live-Robocopy integration tests.
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.
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.
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.
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.
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.
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.
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.
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):
{
"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_command | job, preset, source, destination, include_scripts | Validates job parameters and optionally emits .rcj, .bat, .ps1, and schtasks commands. |
robocopy2rust_parse_command | command | rcj_path | Parses a raw CLI string or UTF-8/UTF-16 .rcj file into normalized command text, warnings, and JSON. |
robocopy2rust_decode_exit_code | code: int | Decodes Robocopy bitmask exit code (0..=16 or cancelled) into severity, flags, and summary. |
robocopy2rust_profiles | action, name, job, store_dir | Performs persistent CRUD (list, get, save, delete) on profiles.json. |
robocopy2rust_dry_run | job | command | preset, source, destination | Executes a non-destructive /L simulation after validation and returns parsed counts & SHA-256 log hash. |
robocopy2rust_run | ..., confirm_destructive: bool | Executes live transfer; strictly refuses /MIR, /PURGE, /MOVE, or /MOV unless confirm_destructive: true. |
robocopy2rust_report | output, format, log_path | job | Generates standalone offline HTML, JSON, Markdown, or all three audit bundles on disk. |
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:
| Exit Code | Bitmask | Outcome | Meaning |
|---|---|---|---|
0 | 0x00 | SUCCESS | No files copied, no failures; source and destination are already synchronized. |
1 | 0x01 | SUCCESS | One or more files were copied successfully (new files added). |
2 | 0x02 | SUCCESS | Extra files or directories were detected in the destination. |
3 | 0x01 | 0x02 | SUCCESS | Files were copied and extra files/directories were detected in destination. |
4 | 0x04 | SUCCESS | Mismatched files or directories were detected. |
5–7 | 0x01..0x04 | SUCCESS | Bitwise combinations of copied, extra, and mismatched file states. |
8 | 0x08 | ERROR | Some files or directories could not be copied after retries (/R:n). |
16 | 0x10 | FATAL | Serious error: invalid usage, missing path, or access denied (zero files copied). |
Command-Line Interface Generator
Build safe, normalized robocopy2rust commands across all 11 subcommands and 8 built-in presets.
robocopy2rust dry-run --source "C:\Data Src" --dest "D:\Backup" --preset safe-backup --report preview.html
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
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).
Linux (64-Bit)
GNU
Native ELF binaries: robocopy2rust, robocopy2rust-iced (wgpu + tiny-skia), and robocopy2rust-mcp.
macOS Apple Silicon
ARM64
Native Mach-O ARM64 binaries for Apple Silicon Mac workstations (author jobs, .rcj/scripts, and audit logs).
macOS Intel (64-Bit)
x86_64Universal 64-bit Intel Mach-O binaries for Intel Mac systems plus full source build instructions via Rust 1.88+.
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.