/cca-doctor

Diagnose installation status and configuration of Claude Code Anywhere.

Installation Modes

First, detect which installation mode is active:

1. Global Install: ~/.claude-code-anywhere/bin/claude shim exists
2. Plugin Install: Installed via claude /plugin add
3. Dogfooding: Running via --plugin-dir . (development mode)

Detection order:

1. Check if ~/.claude-code-anywhere/bin/claude exists → Global Install
2. Check if server is running via API → Some mode is active
3. If server running but no global install → Dogfooding/Plugin mode

Diagnostic Checks

1. Detect Installation Mode

# Check for global install
test -f ~/.claude-code-anywhere/bin/claude && echo "global" || echo "not-global"

# Check server status
${CLAUDE_PLUGIN_ROOT}/scripts/server-status.sh

Based on results:

• Global install exists → Mode: Global Install
• No global install + server running → Mode: Dogfooding/Plugin
• No global install + server not running → Mode: Not Installed

2. Mode-Specific Checks

For Global Install mode:

• ✅/❌ Shim is first in PATH
• ✅/❌ Daemon service running (launchd/systemd)
• ✅/❌ Plugin files exist

For Dogfooding/Plugin mode:

• ✅ Server running (this is what matters!)
• ℹ️ "Global install not configured (optional)"
• ℹ️ "Using plugin via --plugin-dir or /plugin add"

For Not Installed mode:

• ❌ Server not running
• Suggest: Run /cca on or bash scripts/install.sh

3. Channel Configuration (all modes)

Get channel info from server status API response:

• Check channels array in status response
• For each channel, show: name, enabled, connected, config

4. PATH Shim Check (Global Install only)

which -a claude 2>/dev/null | head -5

Only show ❌ if global install exists but shim not first in PATH.

5. Service Status (Global Install only)

macOS:

launchctl list | grep com.claude.code-anywhere 2>/dev/null || echo "not found"

Linux:

systemctl --user is-active claude-code-anywhere.service 2>/dev/null || echo "not found"

Output Format

Global Install Mode:

╭─────────────────────────────────────────╮
│  Claude Code Anywhere - Diagnostics    │
╰─────────────────────────────────────────╯

## Installation Mode
✅ Global Install (all sessions get notifications)

## PATH Check
✅ Shim is first in PATH: ~/.claude-code-anywhere/bin/claude
   Real claude: /opt/homebrew/bin/claude

## Service Status
✅ Daemon running (launchd: com.claude.code-anywhere)

## Server Status
✅ API responding: http://localhost:<port>
   Uptime: 91 minutes
   Active sessions: 1

## Channels
✅ Email: sender@gmail.com → you@example.com
✅ Telegram: Chat ID 123456789

Dogfooding/Plugin Mode:

╭─────────────────────────────────────────╮
│  Claude Code Anywhere - Diagnostics    │
╰─────────────────────────────────────────╯

## Installation Mode
✅ Dogfooding/Plugin Mode (this session only)
   ℹ️ For all sessions, run: bash scripts/install.sh

## Server Status
✅ API responding: http://localhost:<port>
   Uptime: 91 minutes
   Active sessions: 1

## Channels
✅ Email: sender@gmail.com → you@example.com
✅ Telegram: Chat ID 123456789

---
All systems operational for this session.

Not Running:

╭─────────────────────────────────────────╮
│  Claude Code Anywhere - Diagnostics    │
╰─────────────────────────────────────────╯

## Installation Mode
❌ Not running

## Server Status
❌ Server not responding

## Next Steps
- Start notifications: `/cca on`
- Or install globally: `bash scripts/install.sh`

Troubleshooting (Global Install issues only)

Issue	Fix
Shim not first in PATH	source ~/.zshrc or restart terminal
Daemon not running	launchctl load ~/Library/LaunchAgents/com.claude.code-anywhere.plist
Plugin not found	Re-run: bash scripts/install.sh

IDE Notes (Global Install only)

If shim not first in PATH:

VS Code / Cursor:

"terminal.integrated.env.osx": {
  "PATH": "${env:HOME}/.claude-code-anywhere/bin:${env:PATH}"
}

tmux:

set-option -g default-command "exec $SHELL -l"