Agent Mag
SUBSCRIBE
Changelog
Back to Agent Mag changelog

v0.1.3

v0.1.3 - Integrate PostHog analytics

GitHub Release

v0.1.3's headline update: This release completes the Agent Mag PostHog integration on a dedicated branch. It includes 4 merged pull requests with structured public notes, validation, and changelog sync metadata.

This update completes the Agent Mag PostHog integration on a dedicated branch. It moves PostHog client initialization into the Next.js 16 instrumentation-client path, expands the event taxonomy for core product funnels, adds non-blocking server-side capture across key API routes, and gives the CLI a persistent anonymous install ID so successful skill/model installs can be attributed without requiring an account.
Added early PostHog browser initialization with /ingest reverse proxying, uihost, defaults: "2026-01-30", debug-friendly replay, exception autocapture, web vitals, dead-click capture, and masking for password/token/secret fields plus data-mask-recording.
Updated PostHog rewrites so static assets, /ingest/array/:path, /ingest/decide, /ingest/flags, and the catch-all route are ordered correctly.
Standardized client events around lowercase snakecase names and stable properties such as surface, source, slug, category, rank, query, resultcount, plan, provider, UTM fields, and referrer.
Instrumented product funnels for newsletter, auth, article read depth, premium gate, checkout, partner intent, search, bookmarks, skills, models, tools, chat, community, feedback, and account preferences.
Added server-side PostHog helpers that enrich events with IP, user agent, referrer, current URL, pathname, and UTM properties while never blocking user-facing responses.

Why It Matters

PostHog was partially installed, but the app did not have a complete Product OS layer. The missing pieces were reliable early client initialization, stable event naming, server-side route capture, CLI attribution, feature flag/dashboard setup, and proper enrichment support for country/IP analysis. This update turns PostHog into the analytics source for Agent Mag growth, skills/CLI adoption, newsletter conversion, chat usage, revenue intent, web vitals, errors, and replay QA.

The PostHog integration PR was merged after an SEO auto-fix made src/app/skills/[slug]/page.tsx a Client Component while still exporting generateMetadata. Next.js disallows that and CI failed during pnpm build.

Sponsors do not need an admin console. They need a clean workbench for the surfaces they buy and manage: editorial, newsletter, public listings, and boosts. This keeps the sponsor product simple while still using the same Agent Mag app, auth, Cosmos data layer, and Stripe checkout flow.

Agent Mag AI was treating first-party CLI commands like agentmag add as unknown and over-triggering model cards on install-command follow-ups. This gives it concise public Agent Mag product knowledge without dumping raw source code or private implementation internals into OpenClaw.

Feature

What Changed

  • This update completes the Agent Mag PostHog integration on a dedicated branch. It moves PostHog client initialization into the Next.js 16 instrumentation-client path, expands the event taxonomy for core product funnels, adds non-blocking server-side capture across key API routes, and gives the CLI a persistent anonymous install ID so successful skill/model installs can be attributed without requiring an account.
  • Added early PostHog browser initialization with /ingest reverse proxying, uihost, defaults: "2026-01-30", debug-friendly replay, exception autocapture, web vitals, dead-click capture, and masking for password/token/secret fields plus data-mask-recording.
  • Updated PostHog rewrites so static assets, /ingest/array/:path, /ingest/decide, /ingest/flags, and the catch-all route are ordered correctly.
  • Standardized client events around lowercase snakecase names and stable properties such as surface, source, slug, category, rank, query, resultcount, plan, provider, UTM fields, and referrer.
  • Instrumented product funnels for newsletter, auth, article read depth, premium gate, checkout, partner intent, search, bookmarks, skills, models, tools, chat, community, feedback, and account preferences.
  • Added server-side PostHog helpers that enrich events with IP, user agent, referrer, current URL, pathname, and UTM properties while never blocking user-facing responses.
  • Extended /api/skills/install and /api/models/install to accept optional CLI analytics metadata without changing response compatibility.
  • Updated the CLI to generate and persist an anonymous local install ID and send platform, Node version, package manager, and source metadata with install tracking.
  • Split the skill detail route back into a Server Component page and a child Client Component for interactive tracking/copy UI.
  • Kept the SEO metadata and JSON-LD on the server so Next.js 16 can resolve generateMetadata correctly.
  • Preserved the related-content SEO updates by computing related links server-side and passing serializable data into the client component.
  • Simplifies the private partner dashboard into a sponsor workbench for partners.theagentmag.com, while keeping /partners as the public sponsorship sales page.
  • The dashboard now focuses on the actual sponsor workflows: overview, calendar, sponsored articles, newsletter slots, jobs, events, tools, skills, and paid boost checkout. This latest update also cleans up the partner workbench UI so Newsletter and listing pages are no longer cramped side-rail forms.
  • Reworked the partner sidebar to exactly: Overview, Calendar, Articles, Newsletter, Jobs, Events, Tools, Skills.
Improvement

Improvements

  • Integrate PostHog analytics
  • Fix skills metadata build
  • Simplify sponsor workbench
  • Add Agent Mag AI product brain
Fix

Fixes

  • fix(seo): auto-fix SEO issues from GPT-5.4 review
4 PRs/11 commits/3 contributors
v0.1.3 - Integrate PostHog analytics - Agent Mag Changelog