Troubleshooting

Claude Yard won’t start

• Make sure you have Claude Code CLI installed: npm install -g @anthropic-ai/claude-code
• Check that no other process is using ports 9595/9596 (production) or 8587/8588 (dev)

Sessions aren’t showing in the sidebar

• Sessions are read from ~/.claude/projects/. If you’ve never used Claude Code, the directory may not exist yet — spawn your first session and it will appear.
• The sidebar refreshes every 10 seconds. Wait a moment or click the refresh button.

Browser tabs are blank

• Browser tabs require the Electron app. They don’t work in the web-only fallback (npm run dev).
• Try closing and reopening the tab.

Voice control isn’t working

• Check that your microphone permissions are granted in System Settings > Privacy & Security > Microphone.
• Make sure the wake word is enabled in settings.

The app feels stuck or panels are stale

• Restart the app. The server holds in-memory state that can get out of sync after long sessions.