Help
How to seek help, a list of common issues and solutions, and how to report a bug or request a feature.
Rustty is a personal side project with no commercial backing. As such, there is no support team or dedicated resources to help you. The community is very helpful and may provide assistance, and we try to document as many common issues and solutions as possible.
| Issue | Solution |
|---|---|
| Error "missing or unsuitable terminal" when running commands or using SSH. | Terminfo |
| macOS window managers such as Yabai or Aerospace act strange | macOS Tiling Window Managers |
| Rustty has slow startup or high memory usage on Linux. | GTK Single Instance, +new-window |
| "Unable to acquire OpenGL context" error on Linux | GTK OpenGL Context |
| macOS defaults to login shells | macOS Login Shells |
| CLI tools like Claude Code, Docker, etc. repeatedly flash or flicker | Synchronized Output |
If the common issues and solutions above did not help and you can't find an answer in the documentation, the following resources are available:
Please, please, please read the contributing guide on GitHub.
Important
Rustty is a port of Ghostty. Its design and terminal behavior are those of upstream Ghostty, so questions about design or feature direction belong upstream. Rustty's issue tracker is for actionable problems in the port itself. See the contributing guide for more details.