grailward/agent

grailward-agent is a small background program, written in Go, that watches the save folder for the video game Diablo II: Resurrected and backs up your character files and shared stash to the grailward.com platform. It runs quietly as a menu-bar icon on Mac or a system-tray icon on Windows, and the icon's color tells you what is happening: gold means it is syncing, grey means it is paused, and red means there is an error. By default the agent only reads your save files and uploads them, and it never writes anything back to your computer. There is also an opt-in two-way mode that lets it pull newer saves down from the server, but every single write to your disk requires you to confirm it first, whether that is a batch of new files or a one-by-one choice for files that conflict between your machine and the server. The agent also refuses to write anything while it detects the game is actually running, and it backs up any file before overwriting it. Beyond the main save files, the agent can also sync each character's explored map data, sometimes called fog-of-war files, so that your revealed map stays consistent when you play the same character from a different computer. This map syncing can be turned off separately from the main backup feature. The README describes this repository as a public, read-only mirror of the agent's source code, published so people can read exactly what the program does and build it themselves instead of trusting a binary they did not compile. Because it is a mirror, code changes and development happen in a separate private project, but bug reports and suggestions made here are welcome and get applied upstream with credit. The project is organized into a handful of Go files that separate the tray interface, the file-watching logic, the two-way sync logic, and the network client.