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)
pip install mobile-terminal
🍺 Using Homebrew (macOS/Linux)
# Coming soon!
brew tap josharsh/tap
brew install mobile-terminal
📦 Using pipx (Isolated Environment)
pipx install mobile-terminal
🔧 From Source
git clone https://github.com/josharsh/mobile-terminal.git
cd mobile-terminal
pip install -e .
🐳 Using Docker
# 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
# 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:
term-cast ./deploy-to-production.sh
Watch AI coding assistant:
term-cast claude-code
System updates:
term-cast sudo apt upgrade
How it works
- term-cast creates a pseudo-terminal (PTY) that captures all input/output
- Starts a local web server on port 8080
- Your phone connects via WebSocket for real-time streaming
- When input is detected, your phone gets notified
- You can type responses directly from your phone
- 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
--sslflag for HTTPS - Session isolation - each run gets a unique session
License
MIT
Metadata
Release files for mobile-terminal 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mobile_terminal-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for mobile_terminal-0.2.1-py3-none-any.whl |
Release files / mobile_terminal-0.2.1-py3-none-any.whl
| Download URL | mobile_terminal-0.2.1-py3-none-any.whl |
|---|---|
| Size | 14.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1b1445184bb2d495106ae036b5a4cd9dcc31d2df258fd7dedd574ca9fa53506
|
|
BLAKE2b-256 checksum How to use checksums |
7251042425297915e5df58400e896ca5ba640ac9374c990a784b33cfc4169bf9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.10
|
Security for mobile-terminal 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.