Skip to main content

​
overwatch doctor

Check Overwatch installation and configuration for issues.

​
Usage

overwatch doctor

​
Output

Overwatch Doctor
================

Installation
  Version: 1.0.0
  Node.js: v20.10.0 ✓

Configuration
  Config file: overwatch.yaml ✓
  Servers: 2 configured
  Default action: prompt

Data Directory
  Path: ~/.overwatch/
  Audit DB: 2.3 MB ✓
  Sessions DB: 128 KB ✓

Servers
  postgres: command found ✓
  filesystem: command found ✓

All checks passed.

​
Checks Performed

​
Installation

  • Verifies Overwatch version
  • Checks Node.js version (requires 20+)

​
Configuration

  • Locates and validates config file
  • Counts configured servers
  • Shows default action

​
Data Directory

  • Checks ~/.overwatch/ exists
  • Shows audit database size
  • Shows sessions database status

​
Servers

  • Verifies configured server commands exist
  • Checks command accessibility in PATH

​
Exit Codes

CodeMeaning
0All checks passed
1One or more checks failed

​
Troubleshooting

​
Node.js Version Too Old

Installation
  Node.js: v18.0.0 ✗ (requires 20+)
Solution: Upgrade Node.js to version 20 or later.

​
Config File Not Found

Configuration
  Config file: not found
Solution: 
overwatch init

​
Server Command Not Found

Servers
  postgres: command not found ✗
Solution: Install the required MCP server package or check PATH.

​
Audit Database Issues

Data Directory
  Audit DB: error - cannot open
Solution: Check permissions on ~/.overwatch/ directory.