# 使用 Homebrew, Nix 安装 couchbase-shell

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

## 安装

```sh
sudo av install brew:couchbase-shell
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install couchbase-shell
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#couchbase-shell
```

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

## 软件包事实

- **软件包键:** brew:couchbase-shell
- **软件包管理器:** Homebrew
- **版本:** 1.3.0
- **来源摘要:** Modern and fun shell for Couchbase Server and Capella
- **主页:** <https://couchbase.sh>
- **仓库:** <https://github.com/couchbaselabs/couchbase-shell>
- **最后更新:** 2026-05-12T09:55:09Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- cbsh (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

Couchbase Shell is the Couchbase-maintained `cbsh` command-line shell for Couchbase Server and Couchbase Capella, implemented and distributed as a standalone CLI.

### 项目历史

The public GitHub repository was created in 2020 under `couchbaselabs`, and the README describes the project as maintained by Couchbase with community support through the issue tracker rather than Couchbase Enterprise Edition support.

The project reached a tagged 1.0.0 release in 2024 after earlier beta and 0.75.x releases, with later 1.x releases continuing through 2026.

### 采用历史

Official packaging emphasizes downloadable archives for Linux, macOS, and Windows, while the Homebrew formula and Nix package make it available through common developer package managers.

### 使用方式

`cbsh` is used to connect to Couchbase clusters, run commands for buckets, queries, analytics, search, users, Capella projects, and related administrative tasks, and can persist cluster connection details in `~/.cbsh/config`.

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

For package maintainers, Couchbase Shell is notable as a vendor-maintained database shell that ships batteries-included release artifacts and sits alongside Couchbase's older command-line tools rather than replacing a single generic `couchbase` binary.

### 时间线

- 2020: Public GitHub repository created.
- 2021: 1.0.0 beta releases appear.
- 2024: 1.0.0 release published.
- 2026: 1.3.0 release published.

### Related projects

- Couchbase Server
- Couchbase Capella
- Nushell

### 来源

- <https://github.com/couchbaselabs/couchbase-shell>
- <https://api.github.com/repos/couchbaselabs/couchbase-shell>
- <https://github.com/couchbaselabs/couchbase-shell/releases>
- <https://docs.couchbase.com/cloud/reference/command-line-tools.html>
- <https://couchbase.sh/docs/>


## 安全说明

generalized runtime or code generation signal.

- **Geiger 风险:** yellow / 中
- generalized runtime or code generation signal


## 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: ~/.cbsh/config

## Credential files

- Unix: ~/.cbsh/config
## 其他软件包管理器记录

- Nix - couchbase-shell: normalized package name match | nixpkgs package indexes: pkgs/by-name/co/couchbase-shell/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

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


## 来源

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