# 使用 Homebrew 安装 goodls

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

## 安装

```sh
sudo av install brew:goodls
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install goodls
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:goodls
- **软件包管理器:** Homebrew
- **版本:** 3.4.0
- **来源摘要:** CLI tool to download shared files and folders from Google Drive
- **主页:** <https://github.com/tanaikech/goodls>
- **仓库:** <https://github.com/tanaikech/goodls>
- **最后更新:** 2026-07-25T20:55:25-04:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- goodls (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

goodls is a Go CLI for downloading shared Google Drive files and folders. It is a niche but practical package: it turns a browser-heavy, sometimes fragile Google Drive download workflow into a repeatable command-line operation.

### 项目历史

The repository was created on January 10, 2018, the same date the README's update history records v1.0.0 as the initial release. Early changes added stdin URL lists, large-file chunk saving, progress display, and folder downloads that preserve structure when an API key is supplied.

The project continued to track Google Drive behavior changes. The update history records multiple fixes for changed large-file download specifications, a migration to newer Google Drive API client methods, and later work on concurrency, conflict handling, JSON output, proxy and retry behavior, Colab URL handling, and an MCP server mode.

### 采用历史

goodls is distributed as a Homebrew formula and through GitHub release binaries. The README also documents building from source with go install, which keeps it available to Go users even when package-manager coverage is thin.

Its adoption surface is narrower than general-purpose sync tools because it focuses on shared-file and shared-folder downloads rather than full Google Drive synchronization. That specificity is also the reason it is useful in scripts, CI jobs, data pulls, and agent workflows where OAuth setup would be heavy.

### 使用方式

Typical usage is `goodls -u URL` for public shared files without authentication. Entire shared folders require a Google Cloud API key, which can be passed on the command line or through GOODLS_APIKEY, and downloads can preserve folder structure.

The README documents resumable large-file chunks, MIME filtering, output directory selection, conflict strategies, skip-on-error behavior, concurrency control, JSON output, proxy and retry options, and an MCP stdio server exposing a download tool.

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

goodls matters to package nerds as a highly specific web-service CLI: it packages the messy operational knowledge of Google Drive download URLs, warning pages, API-key folder listing, resumable chunks, and headless output into a single executable.

The 2026 MCP mode also makes it an example of a traditional CLI being repurposed as an agent-callable tool while retaining normal shell usage.

### 时间线

- 2018-01-10: Initial release recorded in README update history.
- 2018: stdin URL lists, large-file chunk saving, progress display, folder downloads, API-key support, and Google Docs conversion were added across the 1.0 and 1.1 series.
- 2022: v2.0.0 migrated to updated Google Drive API client methods.
- 2023: v2.0.5 changed API-key large-file download handling after Drive behavior changes.
- 2026-05: v3.2.0 introduced concurrency and multi-progress UI.
- 2026-06: v3.3.x and v3.4.0 added conflict handling, MCP server support, proxy and retry options, JSON output, and Colab URL support.

### Related projects

- Google Drive and the Google Drive API are the service surfaces goodls automates.
- go-getfilelist appears in the README update history as a related library dependency used for Drive file listing.
- rclone and gdown are adjacent tools in the broader command-line cloud-file download space, though goodls is narrower and Drive-share focused.

### 来源

- <https://api.github.com/repos/tanaikech/goodls>
- <https://formulae.brew.sh/formula/goodls>
- <https://github.com/tanaikech/goodls>
- <https://github.com/tanaikech/goodls/releases>
- <https://raw.githubusercontent.com/tanaikech/goodls/master/README.md>


## 安全说明

broad file, network, media, or database tool signal.

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal


## Combined YAML source

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


## 来源

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