macOS
Homebrew已验证 · 100%
brew install ahoylocal Homebrew formula metadata
安装
其他安装命令
Linux
Nix已验证 · 92%
nix profile install nixpkgs#ahoynixpkgs package indexes · pkgs/by-name/ah/ahoy/package.nix · 来源: api.github.com
Windows
Scoop已验证 · 92%
scoop install main/ahoyScoop official bucket manifest trees · bucket/ahoy.json · 来源: api.github.com
Windows Package Manager已验证 · 92%
winget install --id Ahoy.Ahoy -eWindows Package Manager source index · Ahoy.Ahoy · 来源: cdn.winget.microsoft.com
概览
软件包摘要
Creates self documenting CLI programs from commands in YAML files
历史
项目历史与用法
Ahoy is a project-local task runner that turns commands written in a YAML file into a self-documenting CLI. Its purpose is to let each repository expose its own small command surface without requiring contributors to learn a bespoke shell script layout or install a language-specific task runner.
项目历史
The GitHub repository was created in October 2015, and the earliest listed GitHub release is 1.0.0 from the next day. The older Read the Docs site documents the original framing: a zero-code, dependency-free way to give projects their own CLI, particularly for running interactive commands inside Docker containers.
The current README keeps the same core idea while expanding the implementation details: commands live in .ahoy.yml, run relative to that file, can be invoked from subdirectories, and can import multiple config files. The project later moved under the ahoy-cli organization and added newer command-alias, environment-file, and completion features.
采用历史
Ahoy's adoption is strongest in teams that want Makefile-like ergonomics but richer command help and project-local behavior. The README's Docker and database examples reflect its origin in development-environment workflows, especially wrapping docker-compose, shell, database, test, and deployment commands.
The supplied package facts list Homebrew, Nix, Scoop, and winget packages, showing that Ahoy crossed from a macOS/Linux developer convenience into cross-platform package-manager distribution.
使用方式
A project adds a .ahoy.yml file declaring commands, descriptions, aliases, imports, environment files, and an entrypoint. Running ahoy lists commands and per-command help; running ahoy <command> executes the configured shell command relative to the config file.
Official examples include replacing long docker exec invocations with short project commands, initializing an example .ahoy.yml, and using environment files for global or command-specific variables.
为什么软件包爱好者会关心
Ahoy sits in the small but beloved category of developer workflow shims: lighter than a build system, more discoverable than a pile of shell scripts, and easy to package as a single CLI binary. For package maintainers, its value is that the runtime surface is simple while the user-facing workflow can standardize a repository's command vocabulary.
时间线
- 2015: GitHub repository created and release 1.0.0 published.
- 2015: Release 1.1.0 published and documented by the older Read the Docs site.
- 2016-2017: Version 2 alpha and beta releases appeared.
- 2026: Official repository metadata shows continued activity under ahoy-cli/ahoy.
Related projects
- Ahoy overlaps with Make, npm scripts, just, Task, and docker-compose wrapper scripts, but focuses on project-specific command discovery and help.
- The README points to ahoy-cli/zsh-ahoy for dedicated Zsh completion support.
来源
安全态势
风险级别：绿色
narrow executable package without higher-risk signals.
风险分类器
绿色 风险 · 低 置信度 · appliance
原因
- narrow executable package without higher-risk signals
信号
- metadata:no-higher-risk-signals
安装行为
- formula 元数据中未记录 Homebrew post-install 钩子。
- Homebrew bottle 元数据适用于 8 个平台目标。
- 构建元数据列出 1 个构建依赖。
建议审查
在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。
local files
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
Config paths the tool may read or write during local use.
- Unix
.ahoy.yml
可执行文件
已安装的可执行文件
| 命令 | 类型 | 暴露范围 | 备注 |
|---|---|---|---|
ahoy | cli | 全局可执行文件 |
新鲜度
版本和新鲜度
这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。
页面生成时间2026-07-25
管理器版本2.5.0
管理器更新时间2026-07-21
本地数据OK
上游当前
检测到的最新版本v2.5.0
https://github.com/ahoy-cli/ahoy
- OK没有生成新鲜度警告。
安装元数据
软件包元数据
| 软件包键 | brew:ahoy |
|---|---|
| 版本 | 2.5.0 |
| 软件包管理器 | Homebrew |
| 软件包管理器页面 | https://formulae.brew.sh/formula/ahoy |
| 主页 | https://github.com/ahoy-cli/ahoy/ |
| 仓库 | https://github.com/ahoy-cli/ahoy |
| 上游文档 | https://ahoy-cli.readthedocs.io/en/latest |
| 许可证 | MIT |
| 源码归档 | https://github.com/ahoy-cli/ahoy/archive/refs/tags/v2.5.0.tar.gz |
| 最后更新 | 2026-07-21T17:14:18-04:00 |
| Pulse | updated |
| 构建依赖 | go |
| Bottle | 可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux) |
| Homebrew post-install | 未定义 |
| 服务 | 未声明 |
注册表事实
源数据库详情
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | ahoy |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
源数据库匹配
其他软件包管理器记录
匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。
Nix95%
ahoy
nix profile install nixpkgs#ahoy- normalized package name match
- 匹配方式：Ahoy
Scoop95%
main/ahoy
scoop install main/ahoy- normalized package name match
- 匹配方式：Ahoy
winget95%
Ahoy.Ahoy
winget install --id Ahoy.Ahoy -e- normalized package name match
- 匹配方式：Ahoy
来源线索
由仓库数据生成
此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。
Combined YAML source
View the package source record on GitHub.
使用的来源
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment