Doctor Command¶

The doctor command checks your PraisonAIWP configuration and connectivity. It's the first command to run when troubleshooting or setting up a new environment.

Quick Start¶

praisonaiwp doctor

What It Shows¶

Configuration File Location - Where your config is stored (~/.praisonaiwp/config.yaml)
Default Server - Which WordPress site is used by default
All Configured Servers - Table of all servers with their websites and transport types
Connection Test - Optional connectivity verification
Quick Reference Tips - Common commands to get started

Example Output¶

╭──────────────────────────────────────╮
│ PraisonAIWP Doctor                   │
│ Configuration and connectivity check │
╰──────────────────────────────────────╯

Configuration File:
  📁 /Users/you/.praisonaiwp/config.yaml
  ✓ Config file exists

Default Server: default
  🌐 Website: https://your-site.com
  🔌 Transport: ssh
  🖥️  Hostname: your-host

Configured Servers: (3 total)
┏━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━┓
┃ Name      ┃ Website                ┃ Transport  ┃ Default ┃
┡━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━┩
│ default   │ https://your-site.com  │ ssh        │ ✓       │
│ staging   │ https://staging.com    │ ssh        │         │
│ k8s       │ https://k8s-site.com   │ kubernetes │         │
└───────────┴────────────────────────┴────────────┴─────────┘

╭─────────────────────────── Tips ───────────────────────────╮
│ • Config: ~/.praisonaiwp/config.yaml                       │
│ • Default site: https://your-site.com                      │
│ • List posts: praisonaiwp list --server default            │
│ • Create post: praisonaiwp create "Title" --content "HTML" │
╰────────────────────────────────────────────────────────────╯

Options¶

Option	Description
`--server NAME`	Test connection to a specific server
`--verbose, -v`	Show detailed configuration and full settings

Examples¶

Basic Check¶

praisonaiwp doctor

Test Specific Server Connection¶

praisonaiwp doctor --server staging

Verbose Mode¶

praisonaiwp doctor --verbose

Troubleshooting¶

Config Not Found¶

If you see "Config file not found", run:

praisonaiwp init

Connection Failed¶

Verify SSH key is correct in config
Check hostname resolves
Ensure WP-CLI is installed on remote server

For AI Agents¶

Agent Discovery

When working with praisonaiwp, always run doctor first to understand:

Which website is the default target
Available servers and their URLs
Whether the configuration is valid

Development Location: ~/crawler/praisonaiwp

Run with: cd ~/crawler/praisonaiwp && uv run praisonaiwp doctor