Pulse

Abstract

Two packages, one job: show what allow-listed Plugin.Maui.* plugins are doing right now. Plugin.Maui.Pulse is a Debug sink — UseMauiPulse() scans DI and loaded assemblies, stays subscribed, and POSTs JSON to http://127.0.0.1:7878/ (10.0.2.2 on an emulator). Plugin.Maui.Pulse.Cli is the maui-pulse tool that listens and draws NETWORK, API, QUEUE, SYNC, PERMS, HEALTH, LEAK, CRASH, and SESSION. A missing plugin skips that lane (not_installed). Release is off unless Enabled = true. Pulse does not replace MauiDev, maui-perf, or Observability.

Install

dotnet tool install -g Plugin.Maui.Pulse.Cli --source https://api.nuget.org/v3/index.json
dotnet add package Plugin.Maui.Pulse
adb reverse tcp:7878 tcp:7878   # USB Android
maui-pulse attach --package com.myapp.android --android --port 7878

CLI package ID: Plugin.Maui.Pulse.Cli

Host package ID: Plugin.Maui.Pulse (nuget.org)

Plugin.Maui.Pulse.Cli is a global dotnet tool (net10.0). The command stays maui-pulse. Do not run dotnet add package Plugin.Maui.Pulse.Cli in an app. The host package is Plugin.Maui.Pulse — call builder.UseMauiPulse() and still register the plugins the product already uses. Publishing is pipeline-only on the MauiPulse repository.

Commands (1.0.1)

Global options: --package (required on session commands), --android | --ios (required on listen / attach), --port (default 7878), --format human|json, --lanes network,sync,queue (hides rows; does not widen the allow-list), --stdin, --once, --from, --out, --adb, --no-update-check.

maui-pulse attach --package com.test.androidapp --android --port 7878 --no-update-check
maui-pulse attach --package com.test.ios --ios --port 7878
maui-pulse listen --package com.test.androidapp --android --stdin --once --format json
maui-pulse pull --package com.test.androidapp --from ./device-files --out ./pulled
maui-pulse queues --package com.test.androidapp --from ./pulled
maui-pulse sync --package com.test.androidapp --from ./pulled
maui-pulse incident --package com.test.androidapp --from ./pulled --out incident.zip
maui-pulse version

Exit codes: 0 success (including skipped lanes / missing queue files), 1 no allow-listed evidence or bind failed, 2 usage (missing --package, missing platform, unknown command).

JSON

listen --format json and --stdin accept this signal schema. Unknown source values are dropped.

{
  "package": "com.test.androidapp",
  "source": "Plugin.Maui.NetworkMonitor",
  "lane": "network",
  "signal": "StatusChanged",
  "summary": "captive portal",
  "state": "running",
  "at": "2026-09-19T16:00:00Z"
}

Usage and sample results

Each sample is a typical attach or inspector view. A quiet row (—) is waiting, not a failure. USB Android needs adb reverse tcp:7878 tcp:7878 after unplug. Release is off unless options.Enabled = true.

maui-pulse attach --package com.test.androidapp --android --port 7878
maui-pulse attach --package com.test.ios --ios --port 7878 --no-update-check
adb reverse tcp:7878 tcp:7878   # USB Android, then attach

maui-pulse 1.0.1  attach  com.test.androidapp  android  :7878
session 8f2a

NETWORK   Plugin.Maui.NetworkMonitor      captive portal
API       Plugin.Maui.NetworkDiagnostics  —
QUEUE     Plugin.Maui.JobQueue            visits#184
          Plugin.Maui.RetryQueue          — not installed
SYNC      Plugin.Maui.OfflineSync         conflict on Visit
PERMS     Plugin.Maui.PermissionFlow      —
HEALTH    Plugin.Maui.AppHealth           battery 18%
LEAK      Plugin.Maui.LeakAnalyser        —
CRASH     Plugin.Maui.Diagnostics         —
SESSION   Plugin.Maui.DeviceSession       session 8f2a

maui-pulse listen --package com.test.androidapp --android --port 7878
maui-pulse listen --package com.test.androidapp --android --stdin --once --format json

{
  "ok": true,
  "tool": "maui-pulse"
}

{
  "package": "com.test.androidapp",
  "source": "Plugin.Maui.NetworkMonitor",
  "lane": "network",
  "signal": "StatusChanged",
  "summary": "captive portal",
  "state": "running",
  "at": "2026-09-19T16:00:00Z"
}

maui-pulse pull --package com.test.androidapp --from ./device-files --out ./pulled
maui-pulse pull --package com.test.androidapp --from ./device-files --adb

maui-pulse 1.0.1  pull  com.test.androidapp

Copied
  plugin.maui.jobqueue.db3
  offlinesync.db3
  maui-diagnostics/

Skipped
  plugin.maui.retryqueue.db3  (missing)

maui-pulse queues --package com.test.androidapp --from ./pulled

maui-pulse 1.0.1  queues  com.test.androidapp

JobQueue  plugin.maui.jobqueue.db3
  pending  2
  failed   visits#184  last error: timeout
RetryQueue  — file missing

maui-pulse sync --package com.test.androidapp --from ./pulled

maui-pulse 1.0.1  sync  com.test.androidapp

OfflineSync  offlinesync.db3
  pending   3
  conflict  Visit/184  two devices edited the same row

maui-pulse incident --package com.test.androidapp --from ./pulled --out incident.zip

maui-pulse 1.0.1  incident  com.test.androidapp

Wrote incident.zip
  plugin.maui.jobqueue.db3
  offlinesync.db3
  maui-diagnostics/
  manifest.json

maui-pulse version

Plugin.Maui.Pulse.Cli 1.0.1

CI

maui-pulse listen --package com.test.androidapp --android --stdin --once --format json

adb logcat, Charles / Proxyman, Firebase Performance, and Sentry are raw logs, HTTP only, or cloud-after-the-fact. Observability can push; Pulse listens. MauiDev doctors the project. maui-perf wraps maui profile.

Use a plugin instead when

• MauiDev (maui-dev doctor)Diagnose an existing MAUI treeDocs →
• NuvynNew spec-driven MAUI hostDocs →
• Plugin.Maui.Performance / maui-perfStartup and page tracesDocs →
• Plugin.Maui.ObservabilityIn-app telemetry exporterDocs →
• NuvLoc (nuvloc init + /nuvloc.translate)Agent-driven sibling .resx localizationDocs →

Release notes

• 1.0.1. Host and CLI aligned. Host packs snupkg so nuget.org matches other Plugin.Maui.* libraries. CLI still omits snupkg.
• 1.0.0. UseMauiPulse() Debug sink plus maui-pulse attach, listen, pull, queues, sync, incident, and version.
• 1.0.0. Nine closed lanes. Unknown sources dropped. Interactive 4-hour nuget.org update check shared with maui-dev, nuvyn, and maui-perf.