# 使用 Homebrew, Nix, winget 安装 gyb

查看 gyb 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:gyb
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install gyb
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#gyb
```

  证据: nixpkgs package indexes: pkgs/by-name/gy/gyb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id GAM-Team.GotYourBack -e
```

  证据: Windows Package Manager source index: GAM-Team.GotYourBack from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:gyb
- **软件包管理器:** Homebrew
- **版本:** 1.95
- **来源摘要:** CLI for backing up and restoring Gmail messages
- **主页:** <https://github.com/GAM-team/got-your-back/>
- **仓库:** <https://github.com/GAM-team/got-your-back>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- gyb (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.95
## 项目历史与用法

Got Your Back, usually called GYB, is a command-line backup and restore tool for Gmail and Google Workspace mailboxes. Its historical niche is the gap between consumer Gmail export tools, Google Workspace administration, and scriptable local mail preservation.

### 项目历史

The GYB repository identifies the tool as maintained by Jay Lee and describes it as a command-line program for backing up Gmail messages to a local computer using Gmail's API over HTTPS. GitHub repository metadata records the public GAM-team repository as created in June 2014, and the README preserves the earlier jay0lee project links in its release and wiki references.

The project documentation grew around practical setup and recovery tasks rather than a large library API. The wiki walks users through creating a Google Cloud project, granting Gmail access, running estimates, backing up, restoring, using Gmail searches for selective backups, and supporting Google Workspace administrator scenarios.

### 采用历史

GYB adoption tracks administrators and power users who need command-line control over Gmail exports and restores. The project offers Windows installers and Mac/Linux shell installation instructions, while the supplied package facts show Homebrew, Nix, and winget packages, giving it reach across the operating systems commonly used by Google Workspace administrators.

The wiki's emphasis on Gmail.com, Google Workspace, service accounts, Vault, mbox restore, selective search, and daily incremental backup patterns shows why the tool became useful beyond one-off personal backup: it could be scripted into migration, retention, and audit-adjacent workflows.

### 使用方式

The core usage is `gyb --email user@example.com --action backup` to download messages to a local folder, followed by restore commands that can restore to the same mailbox or a different mailbox when a backup folder is supplied. The wiki also documents estimates, label operations, mbox and EML restore, quota checks, service-account modes, and Gmail search filters for scoped backups.

GYB's command-line design is important because Gmail's web UI and Takeout workflows are not shaped for repeatable administrator automation. GYB gives package-managed environments a small executable that can sit in scripts, scheduled jobs, migration runbooks, and support procedures.

### 为什么软件包爱好者会关心

GYB is a package-nerd kind of productivity tool: thin, scriptable, API-backed, and valuable precisely because it turns a cloud service workflow into a reproducible local command. It also brings the usual packaging concerns for OAuth-era CLIs, including installers, Python/runtime expectations, local backup folders, and user-provided Google credentials.

Its relationship to the GAM ecosystem matters because GAM is a well-known Google Workspace administration CLI. GYB is not just another mail downloader; it is part of a cluster of tools used by admins who prefer shellable workflows for Google services.

### 时间线

- 2014: The public GAM-team GitHub repository was created.
- 2010s: GYB documentation centered on Gmail API over HTTPS backups, local restore, and Google Groups support.
- 2020s: The wiki documented Google Workspace naming, Google Cloud project setup, service-account options, Vault, mbox and EML restore, and selective Gmail-search backups.
- 2020s: Package-manager coverage included Homebrew, Nix, and winget according to the supplied package facts.

### Related projects

- GYB is related to GAM and the broader GAM-team Google Workspace administration ecosystem. It also overlaps with Google Takeout, Google Vault exports, Gmail API tooling, mbox/EML mail utilities, and administrator migration scripts.

### 来源

- <https://api.github.com/repos/GAM-team/got-your-back>
- <https://github.com/GAM-team/got-your-back>
- <https://github.com/GAM-team/got-your-back/wiki>
- <https://raw.githubusercontent.com/GAM-team/got-your-back/main/README.md>
- <https://raw.githubusercontent.com/wiki/GAM-team/got-your-back/Home.md>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 其他软件包管理器记录

- Nix - gyb: normalized package name match | nixpkgs package indexes: pkgs/by-name/gy/gyb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - GAM-Team.GotYourBack: normalized package name match | Windows Package Manager source index: GAM-Team.GotYourBack from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/gyb.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gyb.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph