RepoPilot

knadh/listmonk

High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.

Healthy

Strong maintenance signals

ConcernsDependency

copyleft license (AGPL-3.0) — review compatibility

HealthyFork & modify

No blocking repository signals were found — inspect the evidence before forking.

HealthyLearn from

Documented and popular — useful reference codebase to read through.

MixedDeploy as-is

Scorecard "Token-Permissions" is 0/10; 7 cyclic import chains — pervasive coupling

  • ⚠AGPL-3.0 is copyleft — check downstream compatibility
  • ✓Last commit today
  • ✓34+ active contributors
  • ✓Distributed ownership (top contributor 41% of recent commits)
  • ✓AGPL-3.0 licensed
  • ✓CI configured
  • ✓Tests present

What would improve this?

  • •Use as dependency Concerns to Mixed if: relicense under MIT/Apache-2.0 (rare for established libs)
  • •Deploy as-is Mixed to Healthy if: bring "Token-Permissions" to ≥3/10 (see scorecard report)

Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

Informational only. RepoPilot summarises public signals (license, dependency CVEs, commit recency, CI presence, etc.) at the time of analysis. Signals can be incomplete or stale. Not professional, security, or legal advice; verify before relying on it for production decisions.

Repository brief

Repo brief: knadh/listmonk

Generated by RepoPilot · document generated 2026-09-14 · concise human review Evidence snapshot · analyzed 2026-09-14T18:54:11.795Z · commit 670c01717d48

Verdict

Healthy — Strong maintenance signals

  • Last commit today
  • 34+ active contributors
  • Distributed ownership (top contributor 41% of recent commits)
  • AGPL-3.0 licensed
  • 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

listmonk is a self-hosted, single-binary newsletter and mailing list manager written in Go with a Vue.js dashboard, designed for high-performance bulk email delivery. It stores data in PostgreSQL and provides campaign management, subscriber segmentation, bounce handling, and media management without external SaaS dependencies. Monolithic Go backend in internal/ organized by feature (auth, bounce, core, manager, messenger, media) with clear separation between domain logic (core/), email delivery (messenger/), media storage (filesystem/s3), and bounce handling (webhooks for SendGrid/SES/Postmark). Frontend is a separate Vue+TypeScript module (visible via email-builder package.json) using…

Start here

Read these in order:

  • models/bounces.go — Foundation: doesn't import anything internally and is imported by 43 other files. Read first to learn the vocabulary.
  • internal/auth/auth.go — Foundation: imported by 16, no internal dependencies of its own.
  • internal/media/media.go — Built on the foundation; imported by 6 downstream files.
  • frontend/email-builder/src/App/InspectorDrawer/ConfigurationPanel/input-panels/helpers/in… — Built on the foundation; imported by 6 downstream files.
  • internal/notifs/notifs.go — Layer 2 — composes lower-level code into reusable abstractions (imported 7×).

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Check README for instructions.

Daily commands:

Dev server: Evidence incomplete—check repository manifest for frontend yarn dev (Vite dev server on typical port 3000/5173) and go run ./cmd/listmonk for backend. Production: ./listmonk binary reads config…

…shortened for this brief.

Key cautions & unknowns

  • AGPL-3.0 is copyleft — check downstream compatibility
  • PostgreSQL must be running and configured in config.toml before ./listmonk --install (no embedded DB). Email delivery requires valid SMTP credentials and reverse DNS/SPF/DKIM setup to avoid spam filters. Bounce…
  • Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

For the complete agent context, use the CLAUDE.md or Cursor rules export.

Save as

Full context for agent files, or a concise PDF for human review.

View complete agent reference

Open to load every section of the agent reference.

Want this for your own repo?

Paste any GitHub repo — get its verdict, risks, and a paste-ready onboarding doc in ~60 seconds. Free, no sign-up.

Embed the "Healthy" badge

Paste into your README — live-updates from the latest cached analysis.

Variant:
RepoPilot: Healthy
[![RepoPilot: Healthy](https://repopilot.app/api/badge/knadh/listmonk)](https://repopilot.app/r/knadh/listmonk)

Paste at the top of your README.md — renders inline like a shields.io badge.

▸Preview social card

This card auto-renders when someone shares https://repopilot.app/r/knadh/listmonk on X, Slack, or LinkedIn.

Ask AI about knadh/listmonk

Grounded in the actual source code. Pick a starter question or write your own.

What does this repo do, in one paragraph?How would I get started using it?What are the main alternatives?Show me the entry point.
Or write your own question

Similar Go repos

Other healthy-signal Go repos by stars.

Embed this chat in your README

Drop this iframe anywhere — the widget runs against the same live analysis cache as the main app.

<iframe
  src="https://repopilot.app/embed/knadh/listmonk"
  width="100%" height="500"
  style="border:1px solid #d0d7de; border-radius:8px;"
  allow="microphone"
  loading="lazy"
></iframe>