Back to ShellBoard

$ cd ~/support

Support

Something not working right? Email us, report a bug on GitHub, or browse fixes for the most common issues below.

$ cd ~/contact

Contact

I answer e-mails personally, usually within a few business days. Bugs and ideas land best on GitHub.

E-mail petr@calmbit.cz Report a bug (GitHub) github.com/ok2cqr/shellboard

What to include in a report

  • Your operating system and version (macOS / Linux distribution).
  • Your ShellBoard version (Settings → About).
  • The shell you use (zsh, bash, fish, nu or a custom one).
  • Exactly what happened and how to reproduce it step by step.
  • A screenshot or console output if you have one.

$ cd ~/troubleshooting

Troubleshooting

The most common snags are below. For general questions about the app, see the FAQ.

The GitHub build isn't notarized by Apple yet. Open ShellBoard via right-click → Open, or allow it in System Settings → Privacy & Security. If that doesn't help, run xattr -dr com.apple.quarantine /Applications/ShellBoard.app in a terminal. The Mac App Store version won't have this.
The default is your system $SHELL (on Windows pwsh → powershell → cmd). Set a custom shell and arguments in Settings → Shell. If a pane stays empty, make sure the shell path exists and is executable.
Session restore (tabs, splits, directories) must be enabled in Settings → Session. Autosave runs in the background; a system crash may lose the last few seconds. Scrollback restores optionally.
ShellBoard reads git status via the system git. Make sure git is on your PATH and the directory is a git repository. On large repos the status updates with a small delay.
Configuration stays local on your machine (on macOS in ~/Library/Application Support, on Linux in ~/.config). When attaching a log to a report, you'll find it in the same folder.
Update checks are opt-in. You can always download the latest build manually from GitHub Releases. The Mac App Store version updates itself.

$ cd ~/good-to-know

Good to know

Open project, best-effort support

ShellBoard is a native open-source app built on Tauri 2. Support is best-effort — no guaranteed response time, no warranty. Pull requests and issues on GitHub are welcome.

Your data stays with you. No accounts, no tracking — configuration and history never leave your computer. See the GitHub repository for details.