Banpei CLI

The easiest and fastest way to code on the go.

Banpei is a CLI tool that connects your local terminal to a browser-based interface, allowing you to access and control your development environment from anywhere.

What It Does

Banpei creates a secure bridge between your local terminal and a web interface:

• 🔗 Connects your local shell to a browser-based terminal
• 🔐 Secure authentication via Google or GitHub OAuth
• 🔄 Bidirectional mirroring - type from desktop or mobile, both work
• 🌐 Access from anywhere - continue coding from any device with a browser
• 🔒 Privacy-focused - your terminal data is relayed in real-time, not stored

Installation

npm (recommended)

npm install -g banpei

npx (no install required)

npx banpei login

Usage

Start a Session

banpei login

This will:

1. Connect to the Banpei service
2. Display a unique login URL
3. Wait for you to authenticate via browser
4. Establish a secure terminal bridge

How It Works

1. Authenticate: Run banpei login and authenticate via browser
2. Connect: The CLI establishes a WebSocket connection to the Banpei relay server
3. Mirror: Your local terminal is mirrored to the browser in real-time
4. Control: Type commands from either your desktop terminal or the browser interface

Security

• ✅ JWT-based authentication
• ✅ OAuth integration (Google/GitHub)
• ✅ WebSocket connections use secure headers
• ✅ Environment variable whitelisting (only safe vars passed to shell)
• ✅ Input validation on all messages
• ✅ No persistent storage of terminal data

License

MIT