troubleshooting

“permission denied” on macos

go to System Settings → Privacy & Security and allow spacecake to run.

something looks wrong

press ⌘R to refresh the app. if the issue persists in rich mode, switch to source mode to see the underlying markdown.

terminal doesn’t match the app theme

the terminal theme is locked when each tab is created. toggling between light and dark themes won’t update existing terminal tabs. press ⌘R / ctrl+R to reload the app, which restarts all terminal sessions with the new theme.

debugging issues

open Chrome DevTools from within spacecake to view console logs.

slow file watching on linux or windows

spacecake uses @parcel/watcher for detecting file changes. on linux and windows, installing watchman significantly improves file watching performance and reliability for large projects. spacecake will show a tip in the status bar recommending this. see the watchman installation guide for setup instructions.

claude code: IDE disconnected

run /ide in Claude Code to check connection status. select spacecake from the list to reconnect.

claude code: no status line data

• make sure spacecake is running
• verify ~/.claude/settings.json has the correct statusLine configuration (see claude code integration)
• restart Claude Code after making changes