ahoy

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [
    "go"
  ],
  "categories": [],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Creates self documenting CLI programs from commands in YAML files",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:35:19+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "ahoy",
  "github_default_branch": "master",
  "github_last_commit_at": "2026-06-16T01:19:41Z",
  "github_readme_excerpt": "\u003cdiv align=\"center\"\u003e\n\n\u003cpicture\u003e\n  \u003csource srcset=\"img/rect/ahoy-logo-rect-v2.webp\" type=\"image/webp\"\u003e\n  \u003cimg src=\"img/rect/ahoy-logo-rect-v2.svg\" alt=\"Ahoy logo\" width=\"300\"\u003e\n\u003c/picture\u003e\n\n\u003ch1\u003eAhoy!\u003c/h1\u003e\n\n\u003ch3\u003eAutomate and organise your workflows, no matter what technology you use.\u003c/h3\u003e\n\n[![Build and test](https://github.com/ahoy-cli/ahoy/actions/workflows/build_and_test.yml/badge.svg)](https://github.com/ahoy-cli/ahoy/actions/workflows/build_and_test.yml) [![Go Report Card](https://goreportcard.com/badge/github.com/ahoy-cli/ahoy)](https://goreportcard.com/report/github.com/ahoy-cli/ahoy)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-14-orange.svg)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n\n\u003c/div\u003e\n\nAhoy is a command line tool that gives each of your projects its own CLI app with zero code and dependencies.\n\nWrite your commands in a YAML file and then Ahoy gives you lots of features like:\n- a command listing\n- per-command help text\n- command tab completion\n- run commands from any subdirectory\n\nAhoy makes it easy to create aliases and templates for commands that are useful. It was created to help with running interactive commands within Docker containers, but it\u0027s just as useful for local commands, commands over `ssh`, or really anything that could be run from the command line in a single clean interface.\n\n## Examples\n\nSay you want to import a MySQL database running in `docker-compose` using another container called `cli`. The command could look like this:\n\n`docker exec -i $(docker-compose ps -q cli) bash -c \u0027mysql -u$DB_ENV_MYSQL_USER -p$DB_ENV_MYSQL_PASSWORD -h$DB_PORT_3306_TCP_ADDR $DB_ENV_MYSQL_DATABASE\u0027 \u003c some-database.sql`\n\nWith Ahoy, you can turn this into:\n\n`ahoy mysql-import \u003c some-database.sql`\n\n## Quick Start\n\nGet started immediately with our comprehensive examples file:\n\n```bash\n# Create a new project with example commands\nahoy init\n\n# Or download the ",
  "github_repo": "ahoy-cli/ahoy",
  "github_stars": 284,
  "github_topics": [
    "bash",
    "cli",
    "cli-app",
    "command-line",
    "devops",
    "docker",
    "yaml"
  ],
  "homepage": "https://github.com/ahoy-cli/ahoy/",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 20,
  "installs_365d": 259,
  "installs_90d": 42,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "MIT",
  "llm_generated_at": null,
  "llm_model": null,
  "name": "ahoy",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 6818,
  "rank_365d": 6698,
  "rank_90d": 7819,
  "raw_hash": "3fbf16154fac9a30",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/a/ahoy.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "2.5.0",
  "versioned_formulae": [],
  "why_use_this": null
}