Vision Terminal – Support

Connect Beyond Limits

SSH client for Apple Vision Pro

Thank you for using Vision Terminal! We’re here to help you get your servers running in your space.

Getting started

1. Add a connection — tap +, then enter the host name or IP address, port (default 22) and your user name.
2. Choose how to authenticate — password, or an SSH private key you import into the app. Credentials are saved to the visionOS Keychain.
3. Connect — accept the server’s host key the first time, and your shell opens in a spatial window.
4. Work the way you like — open several sessions as tabs, or detach any session into its own window and place it anywhere around you.

Common support topics

• Connecting: host names, ports, jump hosts and connection timeouts
• Key authentication: importing OpenSSH private keys, passphrase-protected keys, key formats
• Terminal behaviour: ANSI/VT100 rendering, colours, resizing, full-screen apps such as vim, htop or tmux
• Keyboard & input: the on-screen accessory key deck (Ctrl, Esc, Tab, arrows, function keys) and hardware Bluetooth keyboards
• Voice dictation: dictating commands and reviewing the text before sending
• Windows & tabs: detaching sessions into separate spatial windows
• Feedback & suggestions: ideas to make Vision Terminal better

Troubleshooting

1. Check the basics — confirm the server is reachable and that your Vision Pro is on a network that can reach it (many servers are only reachable on a LAN or over VPN).
2. Verify the port — if SSH runs on a non-standard port, set it explicitly in the connection profile.
3. Authentication failures — re-enter the password or re-import the key. For key auth, make sure the matching public key is in the server’s ~/.ssh/authorized_keys.
4. Host key changed — if the server was rebuilt, remove and re-add the connection so the new host key can be accepted.
5. Dictation not working — check Settings › Vision Terminal and confirm Microphone and Speech Recognition are allowed.
6. Restart the app — close the window fully and reopen it; this clears most transient issues.
7. Update — make sure you have the latest version of Vision Terminal from the App Store.

Privacy

Vision Terminal stores everything on your device: profiles locally, credentials in the visionOS Keychain. Nothing is sent to the developer. See the full Privacy Policy.

Contact us

If your issue isn’t resolved, you can reach support directly:

impact@cbs-soft.com

Response time: typically within 24–48 hours

Please include:

• Your visionOS version
• The Vision Terminal app version
• The server operating system and SSH server (for example OpenSSH on Ubuntu 24.04)
• A clear description of the issue and any error message shown

Please never send us passwords, private keys or passphrases.

Feedback

We love hearing from our users. Send suggestions, feature requests or ideas to impact@cbs-soft.com and help make Vision Terminal even better.

Thank you for using Vision Terminal!
The Vision Terminal Team