# 使用 Homebrew 安装 ohdear-cli

查看 ohdear-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:ohdear-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install ohdear-cli
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:ohdear-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/ohdear-cli>
- **版本:** 5.2.1
- **来源摘要:** Tool to manage your Oh Dear sites
- **主页:** <https://ohdear.app>
- **仓库:** <https://github.com/ohdearapp/ohdear-cli>
- **上游文档:** <https://ohdear.app>
- **许可证:** MIT
- **源码归档:** <https://github.com/ohdearapp/ohdear-cli/releases/download/v5.2.1/ohdear.phar>
- **最后更新:** 2026-06-15T10:20:21-04:00
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- ohdear (cli)
- ohdear-cli (cli)
- ohdear (别名)
- ohdear-cli (别名)

## 依赖

- php

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 all

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 5.2.1
- 管理器更新时间: 2026-06-15
- 本地数据: OK
- 上游仓库: https://github.com/ohdearapp/ohdear-cli
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://formulae.brew.sh/api/formula/ohdear-cli.json>
- <https://github.com/ohdearapp/ohdear-cli>
- <https://ohdear.app/docs/tools-and-sdks/our-cli-tool>
- <https://raw.githubusercontent.com/ohdearapp/ohdear-cli/main/CHANGELOG.md>
- <https://raw.githubusercontent.com/ohdearapp/ohdear-cli/main/README.md>
- <https://repo.packagist.org/p2/ohdearapp/ohdear-cli.json>
- <https://voke.dev/blog/whats-new-in-ohdear-cli-4>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- 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:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ohdear-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## 相关链接

- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/zh-hans/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/zh-hans/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [php](https://pkg.so/zh-hans/brew/php/) - Runtime dependency declared by Homebrew.
- [monika](https://pkg.so/zh-hans/brew/monika/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [jvm-mon](https://pkg.so/zh-hans/brew/jvm-mon/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [pg_top](https://pkg.so/zh-hans/brew/pg-top/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [runitor](https://pkg.so/zh-hans/brew/runitor/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [memcache-top](https://pkg.so/zh-hans/brew/memcache-top/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [pipemeter](https://pkg.so/zh-hans/brew/pipemeter/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [jvmtop](https://pkg.so/zh-hans/brew/jvmtop/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [cronboard](https://pkg.so/zh-hans/brew/cronboard/) - Shares pkgdb curated category or tags: cli, developer-tools, monitoring.
- [cobo-cli](https://pkg.so/zh-hans/brew/cobo-cli/) - Local metadata places this package in an adjacent workflow. Shared terms: api, api-client, cli, client, developer.
- [chiko](https://pkg.so/zh-hans/brew/chiko/) - Local metadata places this package in an adjacent workflow. Shared terms: api, api-client, cli, client, developer.
- [posting](https://pkg.so/zh-hans/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/mxcl/pkgdb/blob/main/combined/ohdear-cli.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph
