# Install fauna-shell with Homebrew, Nix

Interactive shell for FaunaDB. Version 4.0.0 via Homebrew; verified from local package data. Also installable with nix: nix profile install nixpkgs#fauna-shell.

## Install

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

## Agent safety answer

fauna-shell controls Fauna databases and can execute data mutations.

- **Credential access:** Reads Fauna secrets, endpoint config, and environment credentials.
- **Remote mutation:** Can create, update, delete, and query database resources.
- **Publish/artifact risk:** Can import or export data artifacts.
- **Recommended control:** Gate mutating queries, imports, exports, and secret reads.
- **Agent-use guidance:** Allow safe schema reads; require approval for writes, deletes, and data exports.

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install fauna-shell
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

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

  Evidence: nixpkgs package indexes: pkgs/by-name/fa/fauna-shell/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:fauna-shell
- **Package manager:** Homebrew
- **Version:** 4.0.0
- **Source summary:** Interactive shell for FaunaDB
- **Homepage:** <https://fauna.com/>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- fauna (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 4.0.0

## Security Notes

generalized runtime or code generation signal.

- **Geiger risk:** yellow / medium
- generalized runtime or code generation signal

## Other Package-Manager Records

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


## Sources

- pkg.so package database
- Geiger risk classifier
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer