VibeTerm Support

VibeTerm is an iOS SSH terminal client for remotely connecting to Claude Code sessions running on macOS.

Setup Guide

1. Install cc-status-bar on your Mac
2. Enable SSH on your Mac:
   • Open System Settings → Sharing
   • Turn on "Remote Login"
3. Run cc-status-bar to start the API server
4. On your iPhone:
   • Open VibeTerm
   • Scan the QR code from cc-status-bar, or
   • Manually enter connection details (Host, User, Port)

Requirements

• Mac with macOS and SSH enabled
• cc-status-bar app running on Mac
• iPhone and Mac on the same network (local network or Tailscale VPN)
• iOS 17.0 or later

Features

• SSH terminal emulation with SwiftTerm
• QR code scanning for easy setup
• Custom keyboard optimized for terminal operations
• Real-time Claude Code session monitoring via WebSocket
• ED25519 SSH key authentication
• tmux integration for session management

Troubleshooting

Cannot connect to Mac

• Verify SSH is enabled on Mac (System Settings → Sharing → Remote Login)
• Verify both devices are on the same network
• Check firewall settings allow SSH (port 22)
• Verify the public key is added to ~/.ssh/authorized_keys on your Mac

QR Code scanning not working

• Grant Camera permission in iOS Settings → VibeTerm
• Ensure QR code is clearly visible and well-lit
• Use the manual entry option as an alternative

SSH connection fails

• Verify SSH key is generated (Settings → SSH Key)
• Copy the public key and add it to your Mac's ~/.ssh/authorized_keys
• Test SSH connection from Terminal: ssh username@hostname

WebSocket connection errors

• Verify cc-status-bar is running on your Mac
• Check firewall allows API port (8080) and WebSocket port (8081)
• Verify Local Network permission is granted in iOS Settings

Privacy Policy

View Privacy Policy

© 2026 VibeTerm. All rights reserved.