checkly/checkly-cli

The Checkly CLI gives you a JavaScript/TypeScript-native workflow for coding, testing and deploying synthetic monitoring at scale, from your code base. We call this workflow monitoring as code (MaC).

• Codeable, testable, reviewable monitoring constructs. Works with your dev pipeline. From your IDE, via PR to CI.
• Native @playwright/test support. No lock-in, just write standard *.spec.ts files.
• Alerting baked in. Set alerts for Slack, SMS and many more channels.
• Typescript-first. Fully typed for easy refactoring and code completion.
• Run in the cloud or on-prem. Run on the Checkly cloud or in your network using the Private Locations

A quick example

Monitoring checks are written by instantiating constructs from the checkly/constructs package...

// books-api.check.ts
import { ApiCheck, AssertionBuilder } from 'checkly/constructs'

new ApiCheck('books-api-check-1', {
  name: 'Books API',
  request: {
    url: 'https://danube-web.shop/api/books',
    method: 'GET',
    assertions: [
      AssertionBuilder.statusCode().equals(200),
      AssertionBuilder.jsonBody('$[0].id').isNotNull(),
    ],
  }
})

For browser checks, you can just write standard *.spec.ts files using @playwright/test.

// home.spec.ts
import { test, expect } from '@playwright/test'

test('webshop homepage', async ({ page }) => {
  const response = await page.goto('https://danube-web.shop')
  expect(response?.status()).toBeLessThan(400)
  await expect(page).toHaveTitle(/Danube WebShop/)
  await page.screenshot({ path: 'homepage.jpg' })
})

Run your checks from your local machine or in CI using npx checkly test

npx checkly test
Parsing your project... done

Running 2 checks in eu-west-1.

__checks__/books-api.check.ts
  ✔ Books API 1 (52ms)
__checks__/home.spec.ts
  ✔ home.spec.ts (5s)

2 passed, 2 total

Now deploy your checks to the Checkly cloud so they can monitor your apps and APIs around the clock and alert you when things break.

npx checkly deploy

Parsing your project... done
Successfully deployed project "Acme webapp" to account "Acme Production".

Installation

First, make sure you sign up for a free Checkly account or signup via the terminal using npx checkly login.

Then, the easiest way to get started is to install the CLI using the following command:

npm create checkly@latest

This command will guide you through some simple steps and set up a fully working example project for you. Should take ~1 minute.

You can also set up the CLI from scratch by running:

npm install --save-dev checkly

Docs

Official docs are over at checklyhq.com/docs/cli

AI Agents & Coding Assistants

The Checkly CLI is designed with AI-powered development in mind. With Monitoring as Code, your entire monitoring setup lives in TypeScript files — perfect for AI agents that can read, write, and reason about code.

To give your AI coding assistant full context about the Checkly CLI, install the Checkly skill:

npx skills add checkly/checkly-cli

This provides your AI with documentation, best practices, and examples so it can help you create and manage API checks, browser checks, alert channels, and more.

Check out our AI Agents & Coding Assistants docs for more best practices and examples.

Need help?

• Check out our Getting Started Guide
• Join our Slack Community. The devs who built this hang out there.
• Found a bug? File an issue on this repo

Local Development

Use CHECKLY_CLI_VERSION environment variable to set the latest version you want to test.

To get started with local development check CONTRIBUTING.MD