CLI Skill

The Oh Dear CLI skill teaches AI coding assistants how to use the Oh Dear CLI. Once installed, your AI assistant can run any Oh Dear command on your behalf, covering every endpoint in the Oh Dear API.

Getting started #

First, make sure the Oh Dear CLI is installed and you are logged in:

composer global require ohdearapp/ohdear-cli

ohdear login

You'll be prompted for your API token. Generate one at your API token page.

Then install the skill:

ohdear install-skill

That's it. Your AI assistant now knows how to work with Oh Dear.

What you can do #

Here are some things you can ask your AI assistant after installing the skill:

Investigate downtime #

When something goes wrong, ask your assistant to help you understand the situation:

• "Is example.com up right now?"
• "Show me the downtime history for my API server over the last week"
• "What's the uptime percentage for all my monitors this month?"

Review site health #

Get a quick overview of issues across your monitors:

• "Are there any broken links on example.com?"
• "What do the latest Lighthouse scores look like for my homepage?"
• "Show me the certificate health for all my monitors"
• "Have there been any DNS changes on my domain recently?"

Manage maintenance #

Schedule maintenance windows without leaving your editor:

• "Start a 30-minute maintenance window for monitor 123"
• "Create a scheduled maintenance period for tonight from 2am to 4am"
• "Stop the active maintenance on my staging server"

Post status updates #

Keep your users informed directly from your terminal:

• "Post a status page update saying we're investigating slow response times"
• "Update the status page to say the issue is resolved"

Set up monitoring #

Add and configure monitors:

• "Add a new monitor for https://api.example.com"
• "Create a cron check called 'Nightly backup' that should run every 24 hours"
• "List all my monitors and their current status"

How it works #

The skill provides your AI assistant with documentation about available commands, common workflows, and how to interpret the output. When you make a request, the assistant translates it into the appropriate ohdear CLI commands, runs them, and presents the results in a readable format.

Supported AI assistants #

The skill works with AI coding assistants that support the Skills protocol, including Claude Code.