https://github.com/josharsh/term-cast
term-cast
https://github.com/josharsh/term-cast
Last synced: 4 months ago
JSON representation
term-cast
- Host: GitHub
- URL: https://github.com/josharsh/term-cast
- Owner: josharsh
- License: mit
- Created: 2025-06-16T18:58:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-16T19:00:15.000Z (about 1 year ago)
- Last Synced: 2026-03-14T07:34:56.336Z (4 months ago)
- Language: Python
- Size: 39.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mobile-terminal
The terminal moves with you. Access and control your terminal from any mobile device.
## What it does
mobile-terminal creates a local web server that streams your terminal output to your phone in real-time. When your terminal needs input (like Y/N prompts, passwords, or any user input), you get notified on your phone and can respond directly from there.
Perfect for:
- Long-running scripts that occasionally need input
- Remote deployments that ask for confirmation
- AI coding assistants (like Claude) that need permissions
- Any command that might interrupt your workflow
## Features
- 📱 **Real-time terminal streaming** to your phone
- 🔔 **Instant notifications** when input is needed
- ⌨️ **Send commands** from your phone
- 🚫 **Prevents laptop sleep** while running
- 🔒 **Local network only** - secure by default
- 🎯 **Zero configuration** - just run and go
## Installation
### 🐍 Using pip (Recommended)
```bash
pip install mobile-terminal
```
### 🍺 Using Homebrew (macOS/Linux)
```bash
# Coming soon!
brew tap josharsh/tap
brew install mobile-terminal
```
### 📦 Using pipx (Isolated Environment)
```bash
pipx install mobile-terminal
```
### 🔧 From Source
```bash
git clone https://github.com/josharsh/mobile-terminal.git
cd mobile-terminal
pip install -e .
```
### 🐳 Using Docker
```bash
# Coming soon!
docker run -p 8080:8080 josharsh/mobile-terminal
```
### Requirements
- Python 3.7 or higher
- Works on macOS, Linux, and Windows (WSL)
## Usage
### Basic usage
```bash
# Run any command with mobile-terminal
mobile-terminal npm install
# Or use the short alias
mterm npm install
# Or start an interactive shell
mobile-terminal
# Or simply
mterm
# Then open the URL on your phone:
# http://192.168.1.42:8080
```
### Examples
Monitor a deployment:
```bash
term-cast ./deploy-to-production.sh
```
Watch AI coding assistant:
```bash
term-cast claude-code
```
System updates:
```bash
term-cast sudo apt upgrade
```
## How it works
1. term-cast creates a pseudo-terminal (PTY) that captures all input/output
2. Starts a local web server on port 8080
3. Your phone connects via WebSocket for real-time streaming
4. When input is detected, your phone gets notified
5. You can type responses directly from your phone
6. Laptop stays awake while term-cast is running
## Requirements
- Python 3.7+
- Same WiFi network for laptop and phone
- Modern web browser on phone
## Security
- **Local network only** - no data leaves your network
- **No authentication** by default - only use on trusted networks
- **Optional encryption** - use `--ssl` flag for HTTPS
- **Session isolation** - each run gets a unique session
## License
MIT