Built a CLI tool to manage Uptime Kuma monitors as code (CSV + idempotent sync) - kuma-importer

Hey all,

I built a CLI tool for managing Uptime Kuma monitors as code, and thought it might be useful for others here.

The idea came from needing something safer and more repeatable than manually creating/updating monitors — especially when dealing with larger sets across multiple clients or environments.

### What it does

- Import monitors from CSV or TXT

- Idempotent sync (create / update / skip intelligently)

- Verify state without making changes

- Filter by client

- Limit runs for safe testing

- Export + audit existing monitors

- Safe delete workflows (with confirmation guards)

So you can treat your monitor setup more like infrastructure/config instead of manual UI work.

### Example workflow

- Define monitors in CSV

- Run a dry-run to see changes

- Apply safely

- Re-run → everything stays consistent (no duplicates)

- Clean up unmanaged monitors when needed

### Demo

I recorded a quick end-to-end example:

- create → verify → filter → safe delete

👉 Repo: https://github.com/andrewbergman/kuma-importer

(The README has a short demo GIF if you just want to see it in action.)

Would be great to get some feedback/constructive criticism - plan to probably build out some API integrations with various common MSP tools (the world I happen to live in), but open to suggestions on what would make it more useful.