What CoIsland watches in PostHog

Each monitor kind brings its own query and its own card in the notch.

How to monitor PostHog from your Mac’s notch

PostHog’s own alerts live in PostHog. A CoIsland monitor checks on its own schedule and opens the notch only when something new appears: a row your HogQL finds, an insight past its limit, an exception nobody has seen before.

Each monitor is a file in ~/.coisland/watches:

-- name: Signups spike
-- kind: posthog.insight
-- connector: posthog-12345
-- every: 15m
-- alert: new-rows

insight:AaVQ8Ijw above:1000

Connect PostHog covers the key, every field and each kind; all connectors share one page.

Connect it in three steps

  1. In PostHog, Settings › Personal API keys: create a key limited to your project, with Project, Query, Insight and Error tracking read.

  2. Add a PostHog connector with any address of the project and the key. Test connector says which scope is missing, if any.

  3. Pick a monitor kind or an example: an event spike, tracking that stops, an insight above a number, new exceptions today.

Built for PostHog

  • US Cloud, EU Cloud and self-hosted PostHog: paste the project's address.
  • HogQL runs read-only on PostHog's side, and CoIsland refuses anything but SELECT or WITH.
  • The key stays in the macOS Keychain and goes only to your PostHog.

Then hand it to an agent

A click on the alert opens the agent in a terminal under it, with the whole alert as its first message.

PostHog questions

How do I get an alert when a PostHog insight crosses a number?

Add an Insight threshold monitor, pick the insight and write above or below a number. CoIsland computes the insight at each check, as PostHog shows it, and alerts once as it crosses.

Can CoIsland change anything in PostHog?

No. It reads projects, insights and error tracking, and runs HogQL, which PostHog runs read-only.

Does it work with a self-hosted PostHog?

Yes. Paste an https address of your project on your own host.

Other connectors

Put your work stack in the notch

Regular price: $59.99 Early bird price: $19.99 once, for 2 Macs. Native for Apple Silicon, macOS 14 and later.

Early bird price until October 25