gitwtfhub

wtf is relicta?

swarajban/relicta — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · developerComplexity · 2/5LicenseSetup · moderate

TL;DR

relicta is a single auditable bash script that backs up a curated list of Mac files, such as dotfiles.env files, and uncommitted repos, to S3-compatible storage using restic, fully automated and encrypted.

Mindmap

mindmap
  root((relicta))
    What it does
      Curated backup list
      Client-side encryption
      Unattended scheduling
    Tech stack
      Bash script
      restic
      launchd
      macOS Keychain
    Use cases
      Dotfiles and configs
      Uncommitted repos
      Team backups
    Audience
      Mac developers
      Small teams

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

Automatically back up dotfiles, tool configs, and uncommitted git work from a Mac to S3-compatible storage.

REASON 2

Set up unattended encrypted backups that run on a schedule without manual intervention.

REASON 3

Share one backup bucket across a team with per-engineer encryption and easy offboarding.

What's in the stack?

ShellresticlaunchdmacOS Keychain

How it stacks up

swarajban/relicta123satyajeet123/bitnet-serveradeilsonrbrito/cross-model-consult
Stars000
LanguageShellShellShell
Setup difficultymoderateeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an S3-compatible storage account and granting macOS Full Disk Access to restic.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

relicta is a backup tool for macOS laptops built around restic, an existing open source backup program. Rather than backing up an entire hard drive, it backs up a specific list of folders and files you choose, things you cannot easily get back if they are lost: dotfiles, tool settings.env files, documents, and code repositories with changes that have not been committed anywhere else. The whole tool is a single bash script, so anyone using it can read through the code before trusting it with sensitive data. Setup starts with cloning the repository and running an install script. That script walks you through picking a storage backend (AWS S3, Cloudflare R2, Backblaze B2, or MinIO), storing your credentials in the macOS Keychain, generating a repository password you are required to save somewhere safe, choosing which files to include or exclude, running a first backup, and scheduling future backups to run automatically in the background using macOS's launchd system. Once set up, backups run on their own on a schedule, catching up automatically if the laptop was asleep and skipping runs if it was shut off, so you end up with roughly one backup per day without having to think about it. Old backups are kept on a rotating schedule, a handful of daily copies, several weekly copies, and a run of monthly copies, and older ones are cleaned up automatically. restic encrypts everything on your machine before it gets uploaded, so whichever storage provider you use only ever sees scrambled data. There is also a command for checking backup health, one for testing that a restored file actually matches what is on disk, and a way to run any restic command directly. Teams can use one shared storage bucket with a separate encrypted backup per person, so removing someone's access is a single key revocation. The one manual step macOS requires is granting Full Disk Access to restic, since macOS blocks background processes from reading folders like Desktop and Documents by default. The tool is released under the MIT license.

Yoink these prompts

Prompt 1
Help me write an includes.txt and excludes.txt for relicta to back up my dotfiles and project folders.
Prompt 2
Walk me through setting up relicta with Cloudflare R2 as the storage backend.
Prompt 3
Explain how relicta's launchd scheduling and retention policy work.
Prompt 4
How do I restore a single file using relicta and restic after accidentally deleting it?

Frequently asked questions

wtf is relicta?

relicta is a single auditable bash script that backs up a curated list of Mac files, such as dotfiles.env files, and uncommitted repos, to S3-compatible storage using restic, fully automated and encrypted.

What language is relicta written in?

Mainly Shell. The stack also includes Shell, restic, launchd.

What license does relicta use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is relicta to set up?

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

Who is relicta for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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