# GAM-team/got-your-back

Got Your Back (GYB) is a command line tool for backing up your Gmail messages to your computer using Gmail's API over HTTPS.

Repository: https://github.com/GAM-team/got-your-back
Canonical: https://ross.abutalabs.com/products/got-your-back
Homepage: https://github.com/GAM-team/got-your-back/wiki
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2026-07-08T00:14:10+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 46, longevity 100
- inputs: {"age_days": 4464, "days_push": 57, "days_rel": 362, "gap_med": 1, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3103, forks 243 (observed 2026-08-28T04:07:43.668944+00:00)

## What it is
Got Your Back (GYB) is a Python command line tool that backs up and restores Gmail messages to your local computer using Gmail's API over HTTPS. It works with both Gmail.com and Google Workspace accounts and supports selective backups via Gmail search queries.

## Use cases
- back up my Gmail messages to my local computer
- restore Gmail messages from a backup
- back up a Google Workspace account's email
- selectively back up emails matching a Gmail search query
- create a local archive of my mailbox
- migrate Gmail messages between accounts via backup and restore

## When to choose
- you need a scriptable, command line Gmail backup and restore tool
- you want local, offline copies of Gmail messages using the official Gmail API
- you administer Google Workspace and need to back up or restore user or group mailboxes
- you need selective backups filtered by Gmail search

## When to avoid
- you want a GUI-based email backup solution
- you need to back up providers other than Gmail
- you need continuous real-time email sync rather than scheduled backups
- you prefer a point-and-click desktop application

## Facets
- artifact type: cli-tool
- maturity: active
- function: backup, email, api-framework, cli
- domain: email, developer-tools
- platform: windows, python, cli
- tags: gmail, google-workspace, gmail-api, email-backup, restore, backup, command-line, linux, macos

## Member repositories
- GAM-team/got-your-back (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:43.668944+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:46:11.735819+00:00, confidence not recorded.
  - readme: https://github.com/GAM-team/got-your-back (fetched 2026-08-28T04:07:43.668944+00:00, sha 9bcd5e5589ba)
  - homepage: https://github.com/GAM-team/got-your-back/wiki (fetched 2026-08-29T09:42:06.562476+00:00, sha 5f66a76d87c1)
- Data as of 2026-08-30T08:39:29.467469+00:00.