# 使用 Homebrew, dnf, MacPorts, Nix 安装 gmailctl

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

## 安装

```sh
sudo av install brew:gmailctl
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install gmailctl
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install gmailctl
```

  证据: MacPorts ports tree: mail/gmailctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- dnf (92%):

```sh
sudo dnf install gmailctl
```

  证据: Fedora Rawhide package metadata: gmailctl from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#gmailctl
```

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

## 软件包事实

- **软件包键:** brew:gmailctl
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/gmailctl>
- **版本:** 0.12.0
- **来源摘要:** Declarative configuration for Gmail filters
- **主页:** <https://github.com/mbrt/gmailctl>
- **仓库:** <https://github.com/mbrt/gmailctl>
- **许可证:** MIT
- **源码归档:** <https://github.com/mbrt/gmailctl/archive/refs/tags/v0.12.0.tar.gz>
- **最后更新:** 2026-07-29T16:05:03+02:00
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- gmailctl (cli)
- gmailctl (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 0.12.0
- 管理器更新时间: 2026-07-29
- 本地数据: OK
- 上游仓库: https://github.com/mbrt/gmailctl
- 检测到的最新版本: v0.12.0 (当前)
## 项目历史与用法

gmailctl is a Go command-line tool for maintaining Gmail filters as declarative Jsonnet configuration. It treats mail filtering rules as code: users edit a local configuration, review a diff, and apply the result through the Gmail API instead of importing XML filters by hand.

### 项目历史

The public repository was created in 2018 by Marco Bertoni. The README frames the project around a practical frustration with long, hard-to-audit Gmail filter lists and contrasts gmailctl with tools that generate XML for manual import.

The project developed around a small CLI surface: init, edit, diff, apply, download, export, and debug. Versioned GitHub releases show a 0.x series continuing from 2021 through 2026, with prebuilt binaries and Go installation documented upstream.

### 采用历史

gmailctl's adoption story is that of a focused personal-infrastructure tool rather than a large ecosystem platform. It reached package managers such as Homebrew, Fedora, MacPorts, Nix, and Snap, making a Gmail-account automation workflow installable through normal workstation provisioning.

The repository's star count and package availability indicate a recognizable niche among users who want email rules to live in version control and code review, especially people already comfortable with command-line tools and declarative configuration.

### 使用方式

Practitioners run gmailctl init to set up Gmail API access, then use gmailctl edit or a local Jsonnet file to maintain filters. The tool can show diffs against Gmail settings, apply the local configuration, export XML, and download existing filters as a migration starting point.

Its main operational value is repeatability: filter rules can be reviewed, backed up, refactored, and reapplied, while credentials and tokens stay in the gmailctl configuration directory.

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

For package users, gmailctl is a small example of SaaS configuration drifting into dotfile territory. It packages the hidden state of a Gmail account as a CLI-managed artifact, so a mail workflow can be installed and upgraded alongside other command-line tools.

### 时间线

- 2018: Public GitHub repository created.
- 2021: Version 0.10.0 published in the GitHub releases stream.
- 2026: Version 0.12.0 published.

### Related projects

- gmail-britta is cited by the README as an earlier Gmail-filter DSL approach based around XML import.
- Jsonnet supplies the configuration language used for composable Gmail filter definitions.

### 来源

- <https://api.github.com/repos/mbrt/gmailctl>
- <https://github.com/mbrt/gmailctl>
- <https://github.com/mbrt/gmailctl/releases>


## 安全说明

没有找到 gmailctl 的匹配本地密钥处理 manifest。软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $XDG_CONFIG_HOME/gmailctl/config.jsonnet, ~/.config/gmailctl/config.jsonnet, ~/.gmailctl/config.jsonnet

## Credential files

- Unix: $XDG_CONFIG_HOME/gmailctl/credentials.json, $XDG_CONFIG_HOME/gmailctl/token.json, ~/.config/gmailctl/credentials.json, ~/.config/gmailctl/token.json, ~/.gmailctl/credentials.json, ~/.gmailctl/token.json
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gmailctl
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

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

- Nix - gmailctl: normalized package name match | nixpkgs package indexes: pkgs/by-name/gm/gmailctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- dnf - gmailctl - 0.12.0-2.fc45: normalized package name match | Fedora Rawhide package metadata: gmailctl from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-primary.xml.zst | Declarative configuration for Gmail filters | https://github.com/mbrt/gmailctl
- MacPorts - gmailctl: normalized package name match | MacPorts ports tree: mail/gmailctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## 相关链接

- [Source-control packages](https://pkg.so/zh-hans/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/zh-hans/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [gogcli](https://pkg.so/zh-hans/brew/gogcli/) - Shares pkgdb curated category or tags: automation, cli, gmail, productivity.
- [googleworkspace-cli](https://pkg.so/zh-hans/brew/googleworkspace-cli/) - Shares pkgdb curated category or tags: automation, cli, gmail, productivity.
- [dockutil](https://pkg.so/zh-hans/brew/dockutil/) - Shares pkgdb curated category or tags: automation, cli, configuration, productivity.
- [himalaya](https://pkg.so/zh-hans/brew/himalaya/) - Shares pkgdb curated category or tags: cli, email, productivity.
- [mackup](https://pkg.so/zh-hans/brew/mackup/) - Shares pkgdb curated category or tags: cli, configuration, productivity.
- [mutt](https://pkg.so/zh-hans/brew/mutt/) - Shares pkgdb curated category or tags: cli, email, productivity.
- [tmuxinator](https://pkg.so/zh-hans/brew/tmuxinator/) - Shares pkgdb curated category or tags: automation, cli, productivity.
- [neomutt](https://pkg.so/zh-hans/brew/neomutt/) - Shares pkgdb curated category or tags: cli, email, productivity.
- [imap-backup](https://pkg.so/zh-hans/brew/imap-backup/) - Local package facts share a topical domain. Shared terms: cli, email, gmail, productivity.
- [gmail-getter](https://pkg.so/zh-hans/npm/gmail-getter/) - Local package facts share a topical domain. Shared terms: cli, email, gmail, productivity.

## Combined YAML source

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


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
