peer-term 1.4.4 → 1.4.6

package/README.md

@@ -12,7 +12,7 @@ npx peer-term
 
 This will start a terminal sharing session and give you a 6-digit code.
 
-Share this code with your peer. They can view your terminal by going to https://relay.dhananjaybalekar.in/ and entering the code.
+Share this code with your peer. They can view your terminal by going to https://peerterm.dhananjaybalekar.in/ and entering the code.
 
 ## Global Installation
 
@@ -37,10 +37,38 @@ peer-term --path .                     # starts in current directory
 peer-term --readonly                   # view-only session
 peer-term --secure                     # require fingerprint verification
 peer-term --expiry 10m                 # custom expiry time
+peer-term --rejoin 5m                  # custom reconnection window
 peer-term --relay wss://custom         # use a custom relay server
 peer-term --verbose                    # enable debug logging
 ```
 
+### CLI Highlights
+
+| Flag | Description | Default |
+| :--- | :--- | :--- |
+| `--expiry <time>` | Session expiry duration (e.g. `5m`, `30s`, `1h`) | `5m` |
+| `--rejoin <time>` | Reconnection window if connection drops (e.g. `2m`, `10m`) | `2m` |
+| `--readonly` | Disable client keystrokes (view-only terminal mode) | Off |
+| `--secure` | Enable fingerprint verification for MITM protection | Off |
+| `--path <dir>` | Starting directory for the terminal session | `~` (Home) |
+| `--relay <url>` | Custom relay server WebSocket URL(s) | `wss://relay.dhananjaybalekar.in` |
+| `-V, --verbose` | Enable verbose debug logging | Off |
+| `-h, --help` | Display usage information and exit | — |
+| `-v, --version` | Output version number and exit | — |
+
+### Interactive Controls
+
+While running, you can manage sessions directly from the host CLI:
+
+| Command | Description |
+| :--- | :--- |
+| `n` | Create a new session |
+| `l` | List all active sessions |
+| `a <code>` | Authorize verified fingerprint (in `--secure` mode) |
+| `k <code>` | Kill a specific session |
+| `q` | Quit all sessions and exit |
+
+
 ## Features
 
 - **No Config**: Works instantly. No port forwarding or firewall configuration needed.
@@ -51,6 +79,8 @@ peer-term --verbose                    # enable debug logging
 - **Custom Start Path**: Set the starting directory with `--path`.
 - **Resilient Connections**: Both host and client get a 2-minute rejoin window if their IP changes or connection drops. PTY state is fully preserved — no session restart needed.
 - **Multi-Session**: Manage multiple simultaneous sessions with the interactive CLI menu.
+- **QR Code Support**: Displays a terminal QR code for instant connection from mobile or tablet devices without manually entering the code.
+- **Interactive Controls**: Manage sessions directly from the CLI (`n` for new session, `l` to list, `k` to kill, `a` to authorize fingerprint, `q` to quit).
 
 ## How It Works
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peer-term",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "license": "MIT",
   "description": "Share your terminal instantly using a 6-digit code or QR code. Encrypted. No config.",
   "repository": {

package/src/index.js

@@ -338,6 +338,12 @@ class Session {
       case 'code': {
         this.code = msg.code;
         this.hostToken = msg.hostToken || null;
+        const shareUrl = process.env.PEERTERM_CLIENT_URL || (
+          url.includes('relay.dhananjaybalekar.in')
+            ? 'https://peerterm.dhananjaybalekar.in'
+            : url.replace(/^wss:\/\//i, 'https://').replace(/^ws:\/\//i, 'http://')
+        );
+
         await printSessionBox({
           code: this.code,
           expiry: formatDuration(this.expiryMs),
@@ -345,7 +351,7 @@ class Session {
           mode: (this.readOnly ? 'Read-Only' : 'Read-Write') + (this.secureMode ? ' (Secure)' : ''),
           shell: this.shell,
           startPath: this.startPath,
-          shareUrl: url.replace(/^wss:\/\//i, 'https://').replace(/^ws:\/\//i, 'http://')
+          shareUrl
         });
         if (resolve) resolve(this.code);
         break;

package/src/ui.js

@@ -46,11 +46,11 @@ export function printBanner() {
  * @param {string} opts.mode     - "Read-Write" or "Read-Only"
  * @param {string} opts.shell    - Shell path (e.g. "/bin/zsh")
  * @param {string} [opts.startPath] - Starting directory for the session
- * @param {string} [opts.shareUrl] - URL to share (e.g. "https://peerterm.dev")
+ * @param {string} [opts.shareUrl] - URL to share (e.g. "https://peerterm.dhananjaybalekar.in")
  */
 export async function printSessionBox({ code, expiry, rejoinWindow, mode, shell, startPath, shareUrl }) {
   const spacedCode = code.split('').join(' ');
-  const url = shareUrl || 'https://peerterm.dev';
+  const url = shareUrl || 'https://peerterm.dhananjaybalekar.in';
   const joinUrl = `${url}?code=${code}`;
 
   // Truncate long shell paths to keep box readable