Skip to main content

System Pulse

Is everything working?

System Pulse tells you the state of your entire AI setup in seconds. What’s installed, what’s running, what needs attention.

Commands

ldm doctor

Checks for problems across everything. Missing files, broken settings, outdated versions, failed connections. It tells you what’s wrong and how to fix it. What it checks:
  1. ~/.ldm/ exists
  2. version.json is valid and version matches the CLI
  3. Full system scan (tools, connections, CLIs)
  4. Reconciliation (what’s registered vs what’s actually installed)
  5. Protected folders exist (memory/, agents/, state/, sessions/, messages/)
  6. Claude Code hooks are configured (checks for stale paths)
  7. Connection points are registered
  8. CLI tools are available on PATH
With --fix:
  • Removes stale registry entries (registered but not actually installed)
  • Removes broken hook paths from settings files

ldm status

Shows the full picture. Every tool installed, its version, whether it’s healthy. Quick overview: version, install date, tool count, tool list with versions.

ldm updates

Shows cached update check results. Use --check to re-scan npm for newer versions of your installed tools.

What It Checks

  • Shared Workspace exists and has the right structure
  • All installed tools are present and configured
  • Memory Crystal database is accessible
  • Tools are deployed and up to date
  • Startup files are in place
  • AI personality files exist for each configured AI

Reconciliation

System Pulse compares all sources and determines status:
StatusMeaning
healthyRegistered + deployed + source available
installed-unlinkedRegistered + deployed, no source repo
registered-missingIn registry but not deployed
deployed-unregisteredDeployed but not in registry
mcp-onlyConnection point without LDM management

State Detection

System Pulse scans your real system across multiple sources:
SourceWhat it finds
~/.claude.jsonConnection points (user scope)
~/.ldm/extensions/Deployed tools (LDM)
~/.openclaw/extensions/Deployed tools (OpenClaw)
~/.ldm/extensions/registry.jsonRegistry metadata
PATHCLI tools (with 5s timeout per binary)
~/.openclaw/skills/Deployed skills

Part of LDM OS

System Pulse is included with LDM OS. Available after ldm init.