# Install ohdear-cli with Homebrew Tool to manage your Oh Dear sites. Version 5.2.1 via Homebrew; verified 2026-06-15. ## Install ```sh sudo av install brew:ohdear-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install ohdear-cli ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:ohdear-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 5.2.1 - **Source summary:** Tool to manage your Oh Dear sites - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-15T10:20:21-04:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - ohdear (cli) - ohdear-cli (cli) - ohdear (alias) - ohdear-cli (alias) ## Dependencies - php ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 5.2.1 - Package-manager updated: 2026-06-15 - Local data: ok - Upstream repository: https://github.com/ohdearapp/ohdear-cli - info: No cached GitHub release or tag data was available. ## Project history and usage Oh Dear CLI is the official terminal client for Oh Dear's website monitoring service. It lets operators manage monitors, checks, status pages, maintenance periods, Lighthouse reports, cron checks, tags, and account information from a shell. ### Project history The package began as a Laravel Zero based PHP CLI. Its repository was created on 2018-02-16, and the project changelog records a 1.0.0 entry on 2018-01-18. Packagist records the early package under the `ohdearapp/ohdear-cli` name with the `ohdear-cli` binary and a Laravel Zero 5.6-era dependency set. The tool evolved alongside the Oh Dear API. The 2.x releases in December 2020 and January 2021 added commands for status pages, performance records, maintenance periods, mixed content, broken links, certificate health, checks, uptime, downtime, and cron checks. The 3.x line moved to Laravel Zero 9, dropped PHP 7, and added DNS history, application health, Docker image support, and Lighthouse reports. Version 4.0.0, released on 2023-05-25, renamed the binary from `ohdear-cli` to `ohdear` because the package had become the official CLI. Version 5.0.0, released on 2026-02-23, rewrote the tool around `spatie/laravel-openapi-cli`, replaced more than 30 manually written command classes with OpenAPI-generated commands, changed authentication to `ohdear login` with `~/.ohdear/config.json`, and added an `install-skill` command for AI coding assistants. ### Adoption history Oh Dear CLI's adoption is tied to Oh Dear customers and the PHP/Laravel ecosystem rather than broad general-purpose CLI usage. The official docs describe it as the CLI for every Oh Dear API endpoint, and Homebrew's 2026-07-01 formula API reported 281 installs over 365 days. The binary rename in v4 shows the project moving from a community or companion tool into the service's official command-line interface. Owen Voke's 2023 v4 write-up describes the rename and notes a Homebrew symlink for backward compatibility. ### How it is used Operators authenticate with `ohdear login`, store the API token in `~/.ohdear/config.json`, and run commands such as `list-monitors`, `get-uptime`, `list-broken-links`, `get-certificate-health`, `start-maintenance`, `create-status-page-update`, `list-cron-checks`, and Lighthouse report commands. Commands default to human-readable output and can emit JSON with `--json`. The v5 OpenAPI generation model is important operationally: new Oh Dear API endpoints can become CLI commands without hand-maintaining one command class per endpoint. The CLI also exposes `clear-cache` for cached OpenAPI specs and `install-skill` for AI agent integration. ### Why package nerds care For package nerds, Oh Dear CLI is a tidy example of a SaaS product CLI that changed shape over time: hand-written Laravel Zero commands, official binary naming, PHAR distribution, then OpenAPI-generated command coverage. Its package metadata preserves that evolution through Packagist, Homebrew, and the changelog. It also demonstrates the practical packaging effect of CLI naming. Homebrew exposes both `ohdear` and `ohdear-cli`, while the upstream project treats `ohdear` as the official executable after v4. ### Timeline - 2018-01-18: the changelog records the first release. - 2018-02-16: the GitHub repository was created. - 2020-12-08: version 2.0.0 added many service-management commands and rewrote the tool with Laravel Zero 8. - 2022-03-15: version 3.0.0 moved to Laravel Zero 9, added DNS history commands, and dropped PHP 7. - 2023-05-25: version 4.0.0 renamed the executable from `ohdear-cli` to `ohdear`. - 2026-02-23: version 5.0.0 rewrote command generation around the Oh Dear OpenAPI spec. - 2026-03-23: Packagist published v5.2.1. ### Related projects - The CLI is part of the Oh Dear tool family alongside the Oh Dear PHP SDK, Laravel Nova tooling, API documentation, and AI-agent skill support. Its implementation is also tied to Laravel Zero and Spatie's OpenAPI CLI generator. ### 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: ~/.ohdear/config.json ## Credential files - Unix: ~/.ohdear/config.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** ohdear-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. - [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. - [php](https://www.automicvault.com/pkg/brew/php/) - Runtime dependency declared by Homebrew. - [chronograf](https://www.automicvault.com/pkg/brew/chronograf/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [jvm-mon](https://www.automicvault.com/pkg/brew/jvm-mon/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [jvmtop](https://www.automicvault.com/pkg/brew/jvmtop/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [memcache-top](https://www.automicvault.com/pkg/brew/memcache-top/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [monika](https://www.automicvault.com/pkg/brew/monika/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [pg_top](https://www.automicvault.com/pkg/brew/pg-top/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [pipemeter](https://www.automicvault.com/pkg/brew/pipemeter/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [runitor](https://www.automicvault.com/pkg/brew/runitor/) - Shares av.db curated category or tags: cli, developer-tools, monitoring. - [cobo-cli](https://www.automicvault.com/pkg/brew/cobo-cli/) - Local metadata places this package in an adjacent workflow. Shared terms: api, api-client, cli, client, developer. - [chiko](https://www.automicvault.com/pkg/brew/chiko/) - Local metadata places this package in an adjacent workflow. Shared terms: api, api-client, cli, client, developer. - [posting](https://www.automicvault.com/pkg/brew/posting/) - Local metadata places this package in an adjacent workflow. Shared terms: api, api-client, cli, client, developer. ## Combined YAML source View the package source record on GitHub. [combined/ohdear-cli.yml](https://github.com/automic-vault/db/blob/main/combined/ohdear-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