git404hub

what is agent fr?

grailward/agent — explained in plain English

Analysis updated 2026-05-18

0GoAudience · generalComplexity · 3/5Setup · moderate

tl;dr

A Go menu-bar or tray app that backs up Diablo II: Resurrected save files to grailward.com, with an opt-in, confirmation-gated two-way sync mode.

vibe map

mindmap
  root((grailward-agent))
    What it does
      Watches save folder
      Uploads changed files
      Optional two way pull
    Safety
      Confirm before write
      Backup before overwrite
      Checksum verified
    Tech stack
      Go
      Tray or menu bar UI
    Audience
      Diablo 2 Resurrected players

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically back up Diablo II: Resurrected character saves and shared stash to the cloud.

VIBE 2

Restore or sync save files across multiple computers with explicit confirmation before any overwrite.

VIBE 3

Keep a character's explored map (fog of war) consistent when playing from different machines.

VIBE 4

Build the agent yourself from source instead of trusting a distributed binary.

what's the stack?

Go

how it stacks up fr

grailward/agent42wim/fabio42wim/go-xmpp
Stars0
LanguageGoGoGo
Last pushed2018-02-042020-01-24
MaintenanceDormantDormant
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencegeneralops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a grailward.com account and API token, source is a read-only mirror, not the primary dev repo.

in plain english

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.

prompts (copy fr)

prompt 1
Explain the difference between push and two-way sync modes in grailward-agent.
prompt 2
Walk me through how grailward-agent verifies file integrity before writing a save to disk.
prompt 3
Show me how the watcher.go and pull.go files work together in this project.
prompt 4
Help me understand the map exploration sync feature and how to enable or disable it.

Frequently asked questions

what is agent fr?

A Go menu-bar or tray app that backs up Diablo II: Resurrected save files to grailward.com, with an opt-in, confirmation-gated two-way sync mode.

What language is agent written in?

Mainly Go. The stack also includes Go.

How hard is agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is agent for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.