meerkat-agents
Change Intelligence for Ruby. Create monitors, inspect runs and artifacts, receive signed webhooks.
gem install meerkat-agents
require "meerkat"
Default API base: https://cloud.meerkatagents.com/api/v1
Quick start
1. Sign up
cloud.meerkatagents.com/signup — copy MEERKAT_API_KEY, add your LLM key under LLM key.
2. Create a monitor
client = Meerkat::Client.new(api_key: ENV["MEERKAT_API_KEY"])
client.monitors.create(
description: "Notify me when pricing or plan limits change",
input_params: { url: "https://competitor.com/pricing" },
frequency: "every 6 hours",
output_webhook: "https://myapp.com/webhooks/meerkat"
)
All monitors are recurring. There is no task_type.
3. List / update / delete
client.monitors.list
client.monitors.retrieve(id)
client.monitors.update(id, frequency: "every 12 hours")
client.monitors.pause(id)
client.monitors.resume(id)
client.monitors.delete(id)
4. Runs & artifacts
client.monitors.runs(id)
client.monitors.retrieve_run(id, run_id)
client.monitors.artifacts(id, run_id) # structured findings from the run
client.monitors.run(id) # trigger an on-demand run
5. Webhooks in Rails
class Webhooks::MeerkatController < ApplicationController
include Meerkat::Rails::WebhookVerification
def create
payload = JSON.parse(request.raw_post)
head :ok
end
end
Set MEERKAT_WEBHOOK_SECRET.
Configuration
| Variable | Description |
|---|---|
MEERKAT_API_KEY |
From Cloud signup |
MEERKAT_WEBHOOK_SECRET |
HMAC verification |
MEERKAT_BASE_URL |
Optional; defaults to Cloud |
Pricing
Free: 1 monitor · 1 run. Then $20 — 5 monitors, 50 runs.
Limit hit → Meerkat::SubscriptionRequiredError.