gitwtfhub

wtf is hbackup?

ultraworkers/hbackup — explained in plain English

Analysis updated 2026-07-31 · repo last pushed 2026-06-07

50RustAudience · ops devopsComplexity · 2/5MaintainedSetup · moderate

TL;DR

A Linux backup tool for users of Hermes Agent and OpenClaw that bundles configs, state, workspaces, and databases into compressed archives and optionally uploads them to Google Drive or a remote server.

Mindmap

mindmap
  root((repo))
    What it does
      Creates compressed backups
      Uploads to cloud or server
      Schedules automatic backups
    What it backs up
      Hermes state and logs
      OpenClaw workspace and config
      Systemd service files
      SQLite databases
    How it works
      Single command backup
      Auto command does both
      Dry runs for preview
      Cron for scheduling
    Upload destinations
      Google Drive via rclone
      Remote servers via scp
      Remote servers via rsync
    Tech stack
      Rust
      SQLite backup API
      tar.zst compression
      Linux cron scheduler

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

Why would anyone build with this?

REASON 1

Back up your Hermes Agent and OpenClaw setup into a single compressed archive file.

REASON 2

Schedule nightly backups at 3 AM using cron so your AI workflow data is always protected.

REASON 3

Upload backup archives to Google Drive automatically using rclone configuration.

REASON 4

Safely back up live SQLite databases without corruption using SQLite's built-in backup command.

What's in the stack?

RustSQLiterclonetar.zstcronscprsync

How it stacks up

ultraworkers/hbackuplucifer1004/veloqmirkobozzetto/flowflow
Stars505149
LanguageRustRustRust
Last pushed2026-06-07
MaintenanceMaintained
Setup difficultymoderatemoderatehard
Complexity2/54/54/5
Audienceops devopsdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Hermes Agent and OpenClaw to be installed, plus rclone configuration if uploading to Google Drive.

No license information provided in the README, so usage rights are unclear.

Wtf does this do

hbackup is a backup and restore tool designed for people running Hermes Agent and OpenClaw, two pieces of software that, together, appear to manage AI-related workflows on a Linux system. If you use these tools and want to protect your setup against data loss, this lets you create compressed archive files containing all your configuration, state, workspaces, and related system files, then optionally upload those archives to Google Drive or another server. The tool backs up several specific locations: your Hermes state and logs, your OpenClaw workspace and config, user-level systemd service files, and any SQLite databases involved. It handles live databases carefully by using SQLite's built-in backup command, which avoids corruption that could happen if you just copied a database file mid-write. Everything gets bundled into a compressed archive format called tar.zst. You can add extra directories to include or exclude through a configuration file. The workflow is straightforward. You run a single command to create a backup, and optionally another to upload it somewhere safe. A combined "auto" command does both steps in sequence, which makes it easy to schedule regular backups through cron, a built-in Linux scheduler that can run tasks at set times. The README includes an example that runs a full backup plus upload every night at 3 AM. You can also do dry runs to preview what would happen, list existing backups, and force-restore over existing files when needed. For getting archives off your machine, the tool supports Google Drive through a tool called rclone, and also supports copying to remote servers via scp or rsync. You configure the destination once in a config file and then the upload command handles the rest. The project is built in Rust and was originally extracted from someone's personal setup. The author has since cleaned it up to remove all hardcoded paths, making it work for anyone's home directory automatically. Workspaces are discovered automatically, and any additional custom paths are handled through the config file.

Yoink these prompts

Prompt 1
Set up hbackup on my Linux machine to back up Hermes Agent and OpenClaw workspaces. Show me how to install it, create a backup, and schedule it with cron to run every night at 3 AM.
Prompt 2
Configure hbackup to upload my tar.zst backup archives to Google Drive using rclone. Walk me through the rclone setup and the hbackup config file changes needed.
Prompt 3
Write a cron job that runs the hbackup auto command every night, keeping my Hermes Agent state, OpenClaw workspaces, and SQLite databases backed up to a remote server via rsync.
Prompt 4
Help me do a dry run with hbackup to preview exactly which files and directories will be included in my backup before I commit to running it for real.
Prompt 5
Use hbackup to restore a previous backup archive, overwriting existing files on my system. Show me the restore command with the force flag.

Frequently asked questions

wtf is hbackup?

A Linux backup tool for users of Hermes Agent and OpenClaw that bundles configs, state, workspaces, and databases into compressed archives and optionally uploads them to Google Drive or a remote server.

What language is hbackup written in?

Mainly Rust. The stack also includes Rust, SQLite, rclone.

Is hbackup actively maintained?

Maintained — commit in last 6 months (last push 2026-06-07).

What license does hbackup use?

No license information provided in the README, so usage rights are unclear.

How hard is hbackup to set up?

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

Who is hbackup for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.