# Install woodpecker-cli with Homebrew, apk, Nix, pacman, zypper CLI client for the Woodpecker Continuous Integration server. Version 3.16.0 via Homebrew; verified 2026-06-27. ## Install ```sh sudo av install brew:woodpecker-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install woodpecker-cli ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add woodpecker-cli ``` Evidence: Alpine Linux edge package indexes: woodpecker-cli from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#woodpecker-cli ``` Evidence: nixpkgs package indexes: woodpecker-cli from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix - pacman (92%): ```sh sudo pacman -S woodpecker-cli ``` Evidence: Arch Linux sync databases: woodpecker-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install woodpecker-cli ``` Evidence: openSUSE Tumbleweed package metadata: woodpecker-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:woodpecker-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.16.0 - **Source summary:** CLI client for the Woodpecker Continuous Integration server - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-27T13:09:35Z - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - woodpecker-cli (cli) - woodpecker-cli (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-09 - Package-manager version: 3.16.0 - Package-manager updated: 2026-06-27 - Local data: ok - Upstream repository: https://github.com/woodpecker-ci/woodpecker - Upstream latest detected: v3.16.0 (current) ## Project history and usage Woodpecker CLI is the command-line client for Woodpecker CI, a lightweight, container-oriented continuous integration and delivery system. The CLI is used both as an administrative client for a Woodpecker server and as a local execution tool for testing pipelines before they run on a server. Woodpecker itself is a community continuation of the open-source Drone 0.8 lineage. The Woodpecker documentation states that the project was originally forked from Drone 0.8 after Drone changed its license after that release from Apache 2.0 to a proprietary license, making Woodpecker the branch that continued from the last freely available Drone version. ### Project history The public GitHub repository for Woodpecker was created on 2019-04-03. Its README describes Woodpecker as a simple but powerful CI/CD engine with great extensibility, and the current documentation describes it as lightweight, simple to use, and fast. That positioning reflects its origins as a smaller self-hosted CI system rather than a hosted SaaS CI product. Woodpecker inherited important ideas from Drone: pipeline definitions are container-oriented, steps run in containers, and self-hosted Git forges are central to the expected deployment model. Over time the project developed its own identity, documentation, plugin catalog, Matrix community, Open Collective sponsorship, and release stream. The CLI follows that split between server administration and local developer feedback. The current CLI manual documents global options for server and token configuration, commands for repositories, builds, registries, secrets, users, and contexts, and an `exec` command for executing a local pipeline with metadata and backend options. ### Adoption history Woodpecker's adoption is strongest in the self-hosted and open-source forge ecosystem. The official README says Codeberg uses Woodpecker as its main CI/CD engine, which is a notable adoption signal because Codeberg is a public Git hosting platform focused on privacy and free software development. The GitHub repository also shows substantial community traction for a self-hosted CI project, with thousands of stars and hundreds of forks. Its plugin overview and current documentation indicate a broader ecosystem of core-team and community-maintained plugins. ### How it is used Developers typically use `woodpecker-cli` to authenticate against a Woodpecker server, inspect repositories and builds, manage secrets and registries, or switch named contexts. CI administrators use it as a scriptable surface for operations that would otherwise happen in the web UI. A particularly package-relevant use is `woodpecker-cli exec`, which runs a pipeline locally. The current introductory docs explicitly recommend local workflow execution when a user wants to try a pipeline before installing or using a server, making the CLI useful even outside a full Woodpecker deployment. ### Why package nerds care Woodpecker CLI matters to package users because it is the portable local handle for a self-hosted CI stack. Installing it through a package manager gives developers a stable tool for linting, dry-running, and administering CI without checking a binary into every repository. The Drone lineage is also important to packagers: Woodpecker preserves an Apache-licensed path for users who liked Drone's container pipeline model but wanted a fully open project with community governance. ### Timeline - 2019-04-03: The woodpecker-ci/woodpecker GitHub repository is created. - Drone 0.8 era: Woodpecker is forked from the last Apache-licensed Drone release, according to the official Woodpecker about documentation. - 2020s: Woodpecker develops a current 3.x documentation set, plugin site, public CI instance, and CLI with local `exec` support. - 2026-07-02: GitHub API data showed active repository pushes, reflecting ongoing maintenance at the time of this enrichment run. ### Related projects - Drone CI is the direct upstream lineage through Drone 0.8. - Codeberg is a notable public Woodpecker deployment named in the official README. - Gitea, Forgejo, GitHub, and GitLab are common forge-side companions in Woodpecker deployments. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for woodpecker-cli. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** woodpecker-cli - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - woodpecker-cli: normalized package name match | nixpkgs package indexes: woodpecker-cli from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix - apk - woodpecker-cli - 3.14.1-r1: normalized package name match | Alpine Linux edge package indexes: woodpecker-cli from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Woodpecker Server CLI | https://woodpecker-ci.org - pacman - woodpecker-cli - 3.15.0-1: normalized package name match | Arch Linux sync databases: woodpecker-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A simple CI engine with great extensibility (cli) | https://woodpecker-ci.org - zypper - woodpecker-cli - 3.15.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: woodpecker-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | CLI for the WoodpeckerCI system | https://github.com/woodpecker-ci/woodpecker ## 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. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow 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. - [act](https://www.automicvault.com/pkg/brew/act/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, devops. - [jenkins](https://www.automicvault.com/pkg/brew/jenkins/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, devops. - [jenkins-lts](https://www.automicvault.com/pkg/brew/jenkins-lts/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, devops. - [pipelight](https://www.automicvault.com/pkg/brew/pipelight/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, pipelines. - [tektoncd-cli](https://www.automicvault.com/pkg/brew/tektoncd-cli/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, pipelines. - [brigade-cli](https://www.automicvault.com/pkg/brew/brigade-cli/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [circleci](https://www.automicvault.com/pkg/brew/circleci/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [dagger](https://www.automicvault.com/pkg/brew/dagger/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/woodpecker-cli.yml](https://github.com/automic-vault/db/blob/main/combined/woodpecker-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph