Connection Diagnostics

When things aren't working, random retries waste time. Use this sequence to isolate the problem.

Step 1: Classify the symptom

Step 2: Check the server

On your Mac, verify the server is listening:

lsof -nP -iTCP:8765 -sTCP:LISTEN

You should see a node process. If nothing appears, the server isn't running.

If using Cloudflare Tunnel, also check:

ps aux | grep cloudflared

Step 3: Test network reachability

From another device on the same network (or your Mac itself):

# Test if the port is reachable
nc -zv <mac-ip> 8765
 
# If using a tunnel
curl -I https://your-tunnel-url.trycloudflare.com

If the port isn't reachable, check:

• Mac firewall settings
• The correct network interface (en0 for WiFi, en1 for Ethernet)
• Whether devices are on the same subnet

Step 4: Check Mac performance

If the connection works but feels slow:

# CPU and memory
top -l 1 -s 0 | head -10
 
# Check tmux sessions (are there many?)
tmux list-sessions

A Mac under heavy load will delay terminal output, making it look like a network problem.

Step 5: Refresh the session

If output looks stale or the terminal is blank:

1. Open the session selector in the iPhone app.
2. Re-select the session.
3. This re-attaches to the tmux session and refreshes output.

If the session no longer exists (deleted or server restarted), create a new one.

Step 6: Check notification delivery

If push notifications aren't working:

1. iOS permissions: Settings > Tactic Remote > Notifications > Allow.
2. Hook events: Claude Code fires hook events that the server relays. Make sure the server is receiving them:

   curl -X POST http://localhost:8765/hook -d '{"type":"test"}'

3. App version: Make sure both the Mac app and iOS app are on the latest version.

When to open a support issue

If none of the above resolves the problem, contact support with:

• App version (Mac and iOS)
• Connection mode (Local or Tunnel)
• Steps you tried
• Screenshots or error messages (redact any API keys)