Skip to main content

​
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.