Skip to main content
The checkly.rules.md file includes best practices, example code and required CLI commands to give your AI workflow enough context to perform Checkly-related tasks. Once the Checkly rules are included in your AI context window, your agent can effectively assist you in managing your monitoring setup. It will be able to:

Create new checks, alert channels or other constructs

“Can you create a new BrowserCheck monitoring example.com”

Gather information about the current monitoring setup

“What are the currently used monitoring locations?”

Bulk-update your monitoring resources

“Can you change all checks to run every 5 minutes instead of every 10 minutes?”
With enough application context, you can even create checks for your specific use cases.

Analyze application code and create the monitoring setup

“Can you create new API Checks for the application API endpoints?”
Find a live session explaining how to automate Checkly monitoring with AI below and read the “Agentic Workflows” guide for more details.

​
Claude Code

Claude Code reads instructions from CLAUDE.md files. You can place these files globally (in your home directory) or locally (in your project root). Claude Code automatically includes these files in its context. To use Checkly rules with Claude Code, download the rules file and reference it in your CLAUDE.md: 
mkdir -p .claude &&
curl -o .claude/checkly.rules.md https://www.checklyhq.com/docs/ai/checkly.rules.md -L
echo "- examine checkly.rules.md for code generation rules" >> .claude/CLAUDE.md
Restart your Claude Code session to load the instructions.

​
GitHub Copilot

GitHub Copilot reads project-level instructions from .github/copilot-instructions.md. This file is automatically included in Copilot’s context for all chat interactions. 
mkdir -p .github && curl -o .github/copilot-instructions.md "https://www.checklyhq.com/docs/ai/checkly.rules.md" -L

​
Cursor

Cursor uses .mdc (Markdown Cursor) files stored in .cursor/rules/ for project-specific instructions. These rules are automatically included in Cursor’s context. 
mkdir -p .cursor/rules && curl -o .cursor/rules/checkly.mdc "https://www.checklyhq.com/docs/ai/checkly.rules.md" -L
You can reference the rules file explicitly using @checkly.mdc in your Cursor chats.

​
Windsurf

Windsurf stores rules in .windsurf/rules/ as Markdown files. These are included in the AI context when you interact with Windsurf’s assistant. 
mkdir -p .windsurf/rules && curl -o .windsurf/rules/checkly.md "https://www.checklyhq.com/docs/ai/checkly.rules.md" -L
You can reference the rules file using @checkly.md in your Windsurf chats.