# Install iceberg-cli with Homebrew Command-line interface for Apache Iceberg. Version 0.6.0 via Homebrew; verified 2026-05-28. ## Install ```sh sudo av install brew:iceberg-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install iceberg-cli ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:iceberg-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.6.0 - **Source summary:** Command-line interface for Apache Iceberg - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-05-28T18:47:12Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - iceberg (cli) - iceberg (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.6.0 - Package-manager updated: 2026-05-28 - Local data: ok - Upstream repository: https://github.com/apache/iceberg-go - Upstream latest detected: v0.6.0 (current) ## Project history and usage Apache Iceberg CLI is the command-line program built from Apache Iceberg Go. It gives developers a local `iceberg` executable for catalog inspection, namespace and table operations, snapshot maintenance, rollback, tagging, branch work, and JSON-friendly automation. ### Project history The CLI inherits its significance from Apache Iceberg, the open table format originally developed at Netflix and contributed to the Apache Software Foundation in 2018. Iceberg's format made table metadata, snapshots, schema evolution, hidden partitioning, and multi-engine access central to data-lake operations. The Go implementation made Iceberg usable in Go services and small operational tools without requiring a JVM. Its CLI documentation explicitly says the command is built from `./cmd/iceberg` and that its usage is similar to PyIceberg's CLI, placing it in the growing family of non-Java Iceberg implementations. ### Adoption history The CLI reflects Iceberg adoption moving from engine-integrated libraries into packageable operational tools. The Apache Iceberg site lists Go alongside Python, Rust, and C++ as other implementations, while the Homebrew formula exposes the Go CLI directly as `iceberg`. Its package-manager role is strongest for data engineers who want quick catalog checks, snapshot inspection, and maintenance commands from scripts, CI jobs, or a laptop shell. ### How it is used Typical use starts with a REST, Glue, Hive, or Hadoop catalog URI, optionally read from `~/.iceberg-go.yaml`. Commands cover listing namespaces, creating and describing tables, inspecting snapshots and refs, expiring snapshots, cleaning orphan files, rolling back tables, upgrading table format versions, and emitting JSON for downstream tooling. The CLI is useful as a small operational companion to larger engines such as Spark, Flink, Trino, and Hive rather than as the primary compute engine for queries. ### Why package nerds care For package nerds, `iceberg-cli` is the small executable edge of a very large lakehouse ecosystem. It packages the Iceberg control plane as a Go binary, avoiding a JVM for routine table metadata operations. It also shows the maturation of Apache Iceberg beyond its reference Java library: the same table format is represented by dedicated Go docs, releases, and a Homebrew formula. ### Timeline - 2018: Iceberg was contributed to the Apache Software Foundation. - 2020: Apache Iceberg graduated as an Apache top-level project. - 2024: Apache Iceberg Go began publishing 0.x releases for the Go implementation. - 2026: The Go CLI documentation covers catalog flags, config files, maintenance commands, refs, branches, tags, and JSON automation. ### Related projects - Apache Iceberg is the table format and Java reference implementation behind the ecosystem. - PyIceberg is the Python implementation whose CLI behavior is referenced by the Go CLI documentation. - Apache Iceberg Rust and C++ are sibling non-Java implementations listed by the Apache Iceberg documentation. ### Sources - - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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: ~/.iceberg-go.yaml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** iceberg-cli - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [cubejs-cli](https://www.automicvault.com/pkg/brew/cubejs-cli/) - Shares av.db curated category or tags: cli, data. - [lakekeeper](https://www.automicvault.com/pkg/brew/lakekeeper/) - Shares av.db curated category or tags: apache-iceberg, cli, data, data-lake. - [nessie](https://www.automicvault.com/pkg/brew/nessie/) - Shares av.db curated category or tags: apache-iceberg, cli, data, data-lake. - [burrow](https://www.automicvault.com/pkg/brew/burrow/) - Shares av.db curated category or tags: cli, data, go. - [cayley](https://www.automicvault.com/pkg/brew/cayley/) - Shares av.db curated category or tags: cli, data, go. - [clickhouse-sql-parser](https://www.automicvault.com/pkg/brew/clickhouse-sql-parser/) - Shares av.db curated category or tags: cli, data, go. - [conduit](https://www.automicvault.com/pkg/brew/conduit/) - Shares av.db curated category or tags: cli, data, go. - [ioctl](https://www.automicvault.com/pkg/brew/ioctl/) - Shares av.db curated category or tags: cli, data, go. ## Combined YAML source View the package source record on GitHub. [combined/iceberg-cli.yml](https://github.com/automic-vault/db/blob/main/combined/iceberg-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph