Skip to main content
Run diagnostic checks to verify Ultra is properly configured.

Usage

ultra doctor [flags]

Flags

FlagShortDefaultDescription
--verbose-vfalseShow detailed output
--debugfalseShow detailed detection diagnostics

Examples

# Run diagnostics
ultra doctor

# Show detailed output
ultra doctor --verbose

# Show detection paths and debug info
ultra doctor --debug

Checks Performed

System

  • Go Runtime — Go version and platform
  • Operating System — OS compatibility (macOS, Linux, Windows)

MCP Clients

  • Claude Desktop — Installation and MCP config detection
  • Cursor — Installation and MCP config detection
  • VS Code — Installation and MCP config detection
  • Claude Code — Installation and MCP config detection
  • Goose — Installation and MCP config detection

Configuration

  • Config Directory — Ultra config directory exists (~/.config/ultra/)
  • Config File — Ultra configuration file exists

Dependencies

  • Node.js — Required for npm-based MCP servers
  • Docker — Optional for containerized MCP servers

Output

Each check shows a status icon:
  • Pass — Check succeeded
  • Warning — Optional component missing or not configured
  • Error — Required component missing or broken
The summary shows total checks, passes, warnings, and errors with recommendations for any issues found.