# 使用 Homebrew, Nix 安装 wrkflw 查看 wrkflw 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。 ## 安装 ```sh sudo av install brew:wrkflw ``` 其他安装命令: ### macOS - Homebrew (100%): ```sh brew install wrkflw ``` 证据: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#wrkflw ``` 证据: nixpkgs package indexes: pkgs/by-name/wr/wrkflw/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## 软件包事实 - **软件包键:** brew:wrkflw - **软件包管理器:** Homebrew - **软件包管理器页面:** - **版本:** 0.8.0 - **来源摘要:** Validate and execute GitHub Actions workflows locally - **主页:** - **仓库:** - **上游文档:** - **许可证:** MIT - **源码归档:** - **最后更新:** 2026-05-11T18:23:42-04:00 - **已生成:** 2026-07-08T18:08:21+00:00 ## 可执行文件 - wrkflw (cli) - wrkflw (别名) ## 构建依赖 - pkgconf - rust ## 安装行为 - post-install 钩子: 未定义 - Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## 版本和新鲜度 - 页面生成时间: 2026-07-08 - 管理器版本: 0.8.0 - 管理器更新时间: 2026-05-11 - 本地数据: OK - 上游仓库: https://github.com/bahdotsh/wrkflw - 检测到的最新版本: v0.8.0 (当前) ## 项目历史与用法 wrkflw is a Rust command-line tool for validating and executing GitHub Actions workflows locally. It is a young project, created in 2025, but it has enough primary-source history to describe its niche: local CI workflow feedback before pushing to GitHub. The project overlaps with tools such as `act`, but its README emphasizes validation, a terminal UI, multiple runtimes, expression evaluation, workflow dependency handling, reusable workflows, matrix builds, artifacts, cache, and secrets support. ### 项目历史 The `bahdotsh/wrkflw` repository and crates.io package were created on 29 March 2025. GitHub releases show a fast early cadence in 2025, including 0.3.0 in April, 0.4.0 later that month, and several 0.5 through 0.7 releases in August. By April 2026, wrkflw had reached version 0.8.0. The author's 2026 project note frames wrkflw as both a serious CI-tooling project and a way to learn Rust deeply, specifically citing hard parts such as the expression evaluator, async executor/runtime boundaries, and error design. ### 采用历史 wrkflw's adoption is early but nontrivial for a new CLI: GitHub metadata shows thousands of stars within its first year, while crates.io records the package and version history. Its niche is the developer desire to test GitHub Actions locally rather than discovering workflow syntax or job-ordering problems only after a push. The project also reflects a 2020s shift in CI tooling from remote-only validation toward local emulation. Its README lists Docker, Podman, plain emulation, and secure emulation runtimes, while the author note explains secure emulation as a compromise for users without containers who still need guardrails before running workflow steps locally. ### 使用方式 Users run wrkflw in repositories with GitHub Actions workflow files to validate workflow syntax and execute jobs locally. The tool supports selecting jobs, respecting `needs` dependencies, evaluating GitHub expression syntax, handling matrices, watching files, and using a TUI for workflow, execution, DAG, logs, trigger, secrets, and help views. For package users, the important runtime distinction is container-backed execution versus emulation. The author's note is explicit that secure emulation does not provide full filesystem isolation; it validates commands, strips risky environment variables, applies timeouts, and blocks obvious dangerous patterns, while Docker or Podman remain the stronger boundary. ### 为什么软件包爱好者会关心 wrkflw is significant as a modern local-CI CLI in Rust. It packages a large slice of GitHub Actions behavior into a local executable, giving developers faster feedback loops and package managers another option in the same broad problem space as `act`. Its package-nerd interest is also architectural: CI workflow files combine YAML, expression language semantics, dependency graphs, containers, secrets, and artifacts. A single binary that attempts to validate and emulate that surface is useful even when users still rely on GitHub-hosted runners for final truth. ### 时间线 - 2025-03-29: The GitHub repository and crates.io package are created. - 2025-04-21: wrkflw 0.3.0 is published on GitHub. - 2025-04-30: wrkflw 0.4.0 is published on GitHub. - 2025-08-13: wrkflw 0.7.0 is published on GitHub. - 2026-04-21: wrkflw 0.8.0 is published on GitHub and crates.io. - 2026: The author documents the design motivation behind secure emulation. ### Related projects - nektos/act is the best-known adjacent tool for running GitHub Actions locally. - GitHub Actions is the workflow format and hosted CI service that wrkflw validates and emulates. - Docker and Podman are supported runtimes for container-backed local workflow execution. ### 来源 - - - - - ## 安全说明 narrow executable package without higher-risk signals. - **Geiger 风险:** 绿色 / 低 - narrow executable package without higher-risk signals ## 源数据库详情 - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** wrkflw - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## 其他软件包管理器记录 - Nix - wrkflw: normalized package name match | nixpkgs package indexes: pkgs/by-name/wr/wrkflw/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## 相关链接 - [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/zh-hans/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [pkgconf](https://www.automicvault.com/zh-hans/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew. - [pinact](https://www.automicvault.com/zh-hans/pkg/brew/pinact/) - Shares av.db curated category or tags: ci, cli, developer-tools, github-actions. - [litani](https://www.automicvault.com/zh-hans/pkg/brew/litani/) - Shares av.db curated category or tags: ci, cli, developer-tools. - [actionlint](https://www.automicvault.com/zh-hans/pkg/brew/actionlint/) - Shares av.db curated category or tags: ci, cli, developer-tools, github-actions. - [actions-up](https://www.automicvault.com/zh-hans/pkg/brew/actions-up/) - Shares av.db curated category or tags: ci, cli, developer-tools, github-actions. - [travis](https://www.automicvault.com/zh-hans/pkg/brew/travis/) - Shares av.db curated category or tags: ci, cli, developer-tools. - [act](https://www.automicvault.com/zh-hans/pkg/brew/act/) - Shares av.db curated category or tags: cli, developer-tools, github-actions. - [action-docs](https://www.automicvault.com/zh-hans/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, github-actions. - [action-validator](https://www.automicvault.com/zh-hans/pkg/brew/action-validator/) - Shares av.db curated category or tags: cli, developer-tools, github-actions. ## Combined YAML source View the package source record on GitHub. [combined/wrkflw.yml](https://github.com/automic-vault/db/blob/main/combined/wrkflw.yml) ## 来源 - 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