janus-remote 0.1.0__tar.gz

janus_remote-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 He Who Seeks
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

janus_remote-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: janus-remote
+Version: 0.1.0
+Summary: Voice-to-text paste bridge for Claude CLI on remote SSH sessions
+Author: He Who Seeks
+License: MIT
+Project-URL: Homepage, https://github.com/anthropics/janus
+Project-URL: Repository, https://github.com/anthropics/janus
+Keywords: claude,voice,ssh,remote,paste,janus
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: websocket-client>=1.0.0
+Dynamic: license-file
+
+# janus-remote
+
+Voice-to-text paste bridge for Claude CLI on remote SSH sessions.
+
+Use your voice to interact with Claude CLI running on remote servers, with transcriptions pasted directly into the terminal - no window switching needed!
+
+## Installation
+
+```bash
+pip install janus-remote
+```
+
+## Requirements
+
+1. **Local Mac**: Janus Electron app running (provides voice recognition + WebSocket server)
+2. **SSH Config**: Port forwarding enabled (one-time setup)
+
+## SSH Setup (One-Time)
+
+Add this to your `~/.ssh/config` on your **local Mac**:
+
+```
+Host *
+    RemoteForward 9473 localhost:9473
+```
+
+Or for specific hosts:
+
+```
+Host myserver
+    HostName myserver.example.com
+    RemoteForward 9473 localhost:9473
+```
+
+This forwards the Janus WebSocket bridge (port 9473) to the remote server.
+
+## Usage
+
+On your remote server via SSH:
+
+```bash
+# Start a new Claude session with voice paste support
+claude-janus
+
+# Resume a previous session
+claude-janus --resume
+claude-janus -r
+```
+
+## How It Works
+
+```
+LOCAL MAC                           REMOTE SERVER (via SSH)
+┌─────────────────────┐             ┌─────────────────────┐
+│ Janus Electron      │             │ claude-janus        │
+│ (Voice Recognition) │             │ (This package)      │
+│         │           │             │         │           │
+│         ▼           │             │         │           │
+│ WebSocket :9473 ────┼─────────────┼───────► │           │
+│                     │  SSH Tunnel │         ▼           │
+│                     │             │ Inject into PTY     │
+└─────────────────────┘             └─────────────────────┘
+```
+
+1. Speak into your Mac's microphone
+2. Janus transcribes and sends via WebSocket
+3. SSH tunnel forwards to remote server
+4. `claude-janus` receives and injects text directly into Claude CLI
+
+## Features
+
+- **Zero latency feel**: WebSocket connection, no polling
+- **Background paste**: No window switching - text appears directly in terminal
+- **Multi-session support**: Run multiple `claude-janus` sessions on different servers
+- **Auto-reconnect**: Handles connection drops gracefully
+
+## Troubleshooting
+
+### "Bridge connection failed"
+- Ensure Janus Electron is running on your local Mac
+- Verify SSH port forwarding is configured
+- Check that port 9473 isn't blocked
+
+### "Could not find 'claude' binary"
+- Install Claude CLI: `npm install -g @anthropic-ai/claude-cli`
+- Or ensure it's in your PATH
+
+## License
+
+MIT
+
+## Author
+
+He Who Seeks

janus_remote-0.1.0/README.md

@@ -0,0 +1,94 @@
+# janus-remote
+
+Voice-to-text paste bridge for Claude CLI on remote SSH sessions.
+
+Use your voice to interact with Claude CLI running on remote servers, with transcriptions pasted directly into the terminal - no window switching needed!
+
+## Installation
+
+```bash
+pip install janus-remote
+```
+
+## Requirements
+
+1. **Local Mac**: Janus Electron app running (provides voice recognition + WebSocket server)
+2. **SSH Config**: Port forwarding enabled (one-time setup)
+
+## SSH Setup (One-Time)
+
+Add this to your `~/.ssh/config` on your **local Mac**:
+
+```
+Host *
+    RemoteForward 9473 localhost:9473
+```
+
+Or for specific hosts:
+
+```
+Host myserver
+    HostName myserver.example.com
+    RemoteForward 9473 localhost:9473
+```
+
+This forwards the Janus WebSocket bridge (port 9473) to the remote server.
+
+## Usage
+
+On your remote server via SSH:
+
+```bash
+# Start a new Claude session with voice paste support
+claude-janus
+
+# Resume a previous session
+claude-janus --resume
+claude-janus -r
+```
+
+## How It Works
+
+```
+LOCAL MAC                           REMOTE SERVER (via SSH)
+┌─────────────────────┐             ┌─────────────────────┐
+│ Janus Electron      │             │ claude-janus        │
+│ (Voice Recognition) │             │ (This package)      │
+│         │           │             │         │           │
+│         ▼           │             │         │           │
+│ WebSocket :9473 ────┼─────────────┼───────► │           │
+│                     │  SSH Tunnel │         ▼           │
+│                     │             │ Inject into PTY     │
+└─────────────────────┘             └─────────────────────┘
+```
+
+1. Speak into your Mac's microphone
+2. Janus transcribes and sends via WebSocket
+3. SSH tunnel forwards to remote server
+4. `claude-janus` receives and injects text directly into Claude CLI
+
+## Features
+
+- **Zero latency feel**: WebSocket connection, no polling
+- **Background paste**: No window switching - text appears directly in terminal
+- **Multi-session support**: Run multiple `claude-janus` sessions on different servers
+- **Auto-reconnect**: Handles connection drops gracefully
+
+## Troubleshooting
+
+### "Bridge connection failed"
+- Ensure Janus Electron is running on your local Mac
+- Verify SSH port forwarding is configured
+- Check that port 9473 isn't blocked
+
+### "Could not find 'claude' binary"
+- Install Claude CLI: `npm install -g @anthropic-ai/claude-cli`
+- Or ensure it's in your PATH
+
+## License
+
+MIT
+
+## Author
+
+He Who Seeks

janus_remote-0.1.0/janus_remote/__init__.py

@@ -0,0 +1,18 @@
+"""
+Janus Remote - Voice-to-text paste bridge for Claude CLI on remote SSH sessions
+
+Usage:
+    pip install janus-remote
+    claude-janus  # Start Claude with voice paste support
+
+Requires:
+    - Janus Electron app running on your local Mac
+    - SSH port forwarding: RemoteForward 9473 localhost:9473
+"""
+
+__version__ = "0.1.0"
+__author__ = "He Who Seeks"
+
+from .pty_capture import main as run_pty_capture
+
+__all__ = ["run_pty_capture", "__version__"]

janus_remote-0.1.0/janus_remote/cli.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""
+CLI entry point for janus-remote
+
+Usage:
+    claude-janus              # Start new Claude session with voice paste
+    claude-janus --resume     # Resume previous session
+    claude-janus -r           # Short form resume
+"""
+
+import sys
+import os
+import shutil
+
+
+def find_claude():
+    """Find the claude binary location"""
+    # Check PATH first
+    claude_path = shutil.which('claude')
+    if claude_path:
+        return claude_path
+
+    # Common locations
+    common_paths = [
+        '/usr/local/bin/claude',
+        '/opt/homebrew/bin/claude',
+        os.path.expanduser('~/.local/bin/claude'),
+        os.path.expanduser('~/bin/claude'),
+        '/usr/bin/claude',
+    ]
+
+    for path in common_paths:
+        if os.path.isfile(path) and os.access(path, os.X_OK):
+            return path
+
+    return None
+
+
+def main():
+    """Main entry point"""
+    # Find claude
+    claude_path = find_claude()
+
+    if not claude_path:
+        print("Error: Could not find 'claude' binary.", file=sys.stderr)
+        print("Please ensure Claude CLI is installed and in your PATH.", file=sys.stderr)
+        print("Install: npm install -g @anthropic-ai/claude-cli", file=sys.stderr)
+        sys.exit(1)
+
+    # Check for resume flag
+    args = sys.argv[1:]
+    if args and args[0] in ('--resume', '-r', 'resume'):
+        args[0] = '--resume'
+
+    # Import and run the PTY capture
+    from .pty_capture import run_claude_session
+
+    try:
+        run_claude_session(claude_path, args)
+    except KeyboardInterrupt:
+        print("\nSession interrupted.")
+        sys.exit(0)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

janus_remote-0.1.0/janus_remote/pty_capture.py

@@ -0,0 +1,234 @@
+#!/usr/bin/env python3
+"""
+PTY Capture for Janus Remote
+
+Wraps Claude CLI in a PTY and connects to local Janus via WebSocket
+for voice-to-text paste support over SSH.
+"""
+
+import sys
+import os
+import pty
+import select
+import termios
+import tty
+import subprocess
+from datetime import datetime
+import signal
+import fcntl
+import time
+import json
+import re
+import threading
+import socket
+
+# WebSocket bridge port (must match Janus Electron)
+JANUS_BRIDGE_PORT = 9473
+
+# Regex to strip title escape sequences
+TITLE_ESCAPE_PATTERN = re.compile(rb'\x1b\][012];[^\x07\x1b]*(?:\x07|\x1b\\)')
+
+
+def get_janus_title():
+    """Get session title from environment"""
+    return os.environ.get('JANUS_TITLE', '')
+
+
+class RemotePasteClient:
+    """WebSocket client for receiving pastes from local Janus via SSH port forwarding"""
+
+    def __init__(self, master_fd, port=JANUS_BRIDGE_PORT):
+        self.master_fd = master_fd
+        self.port = port
+        self.ws = None
+        self.running = True
+        self.connected = False
+        self.client_thread = None
+        self.session_id = f"pty-{os.getpid()}-{int(time.time())}"
+
+    def start(self):
+        """Start the WebSocket client in a background thread"""
+        self.client_thread = threading.Thread(target=self._run_client, daemon=True)
+        self.client_thread.start()
+
+    def _run_client(self):
+        """Main client loop - connect and listen for pastes"""
+        try:
+            import websocket
+        except ImportError:
+            print("[janus-remote] websocket-client not installed. Run: pip install websocket-client", file=sys.stderr)
+            return
+
+        while self.running:
+            try:
+                ws_url = f"ws://localhost:{self.port}"
+                print(f"[janus-remote] Connecting to Janus bridge at {ws_url}...", file=sys.stderr)
+
+                self.ws = websocket.create_connection(ws_url, timeout=5)
+                self.connected = True
+                print("[janus-remote] Connected to Janus bridge!", file=sys.stderr)
+
+                # Register this session
+                my_title = get_janus_title()
+                hostname = socket.gethostname()
+                register_msg = json.dumps({
+                    'type': 'register',
+                    'sessionId': self.session_id,
+                    'title': my_title,
+                    'hostname': hostname
+                })
+                self.ws.send(register_msg)
+
+                # Listen for messages
+                while self.running and self.connected:
+                    try:
+                        self.ws.settimeout(1.0)
+                        message = self.ws.recv()
+                        if message:
+                            self._handle_message(message)
+                    except websocket.WebSocketTimeoutException:
+                        try:
+                            self.ws.send(json.dumps({'type': 'ping'}))
+                        except:
+                            break
+                    except websocket.WebSocketConnectionClosedException:
+                        break
+                    except Exception:
+                        break
+
+            except Exception as e:
+                if self.running:
+                    print(f"[janus-remote] Bridge connection failed: {e}", file=sys.stderr)
+                self.connected = False
+
+            if self.running:
+                time.sleep(5)
+
+    def _handle_message(self, message):
+        """Handle incoming WebSocket message"""
+        try:
+            msg = json.loads(message)
+            msg_type = msg.get('type')
+
+            if msg_type == 'paste':
+                text = msg.get('text', '')
+                if text:
+                    self._inject_text(text)
+            elif msg_type == 'registered':
+                print(f"[janus-remote] {msg.get('message', 'Registered')}", file=sys.stderr)
+
+        except json.JSONDecodeError:
+            pass
+
+    def _inject_text(self, text):
+        """Inject text directly into the PTY"""
+        try:
+            encoded = text.encode('utf-8')
+            chunk_size = 256
+            for i in range(0, len(encoded), chunk_size):
+                chunk = encoded[i:i + chunk_size]
+                os.write(self.master_fd, chunk)
+                if len(encoded) > chunk_size:
+                    time.sleep(0.02)
+
+            time.sleep(0.15)
+            os.write(self.master_fd, b'\r')
+        except OSError as e:
+            print(f"[janus-remote] Paste error: {e}", file=sys.stderr)
+
+    def stop(self):
+        """Stop the client"""
+        self.running = False
+        self.connected = False
+        if self.ws:
+            try:
+                self.ws.close()
+            except:
+                pass
+
+
+def run_claude_session(claude_path, args):
+    """Run Claude CLI wrapped in PTY with Janus voice paste support"""
+
+    # Save original terminal settings
+    old_tty = termios.tcgetattr(sys.stdin)
+
+    try:
+        # Create a pseudo-terminal
+        master_fd, slave_fd = pty.openpty()
+
+        # Fork and run Claude in the child process
+        pid = os.fork()
+
+        if pid == 0:  # Child process
+            os.close(master_fd)
+            os.setsid()
+            os.dup2(slave_fd, 0)  # stdin
+            os.dup2(slave_fd, 1)  # stdout
+            os.dup2(slave_fd, 2)  # stderr
+
+            # Run Claude
+            os.execv(claude_path, [claude_path] + args)
+
+        else:  # Parent process
+            os.close(slave_fd)
+
+            # Set stdin to raw mode
+            tty.setraw(sys.stdin.fileno())
+
+            # Make master_fd non-blocking
+            flags = fcntl.fcntl(master_fd, fcntl.F_GETFL)
+            fcntl.fcntl(master_fd, fcntl.F_SETFL, flags | os.O_NONBLOCK)
+
+            # Initialize Remote Paste Client
+            remote_client = RemotePasteClient(master_fd)
+            remote_client.start()
+
+            while True:
+                rfds, _, _ = select.select([sys.stdin, master_fd], [], [], 0.01)
+
+                # Check if child has exited
+                pid_status = os.waitpid(pid, os.WNOHANG)
+                if pid_status[0] != 0:
+                    break
+
+                if sys.stdin in rfds:
+                    try:
+                        data = os.read(sys.stdin.fileno(), 1024)
+                        if data:
+                            os.write(master_fd, data)
+                    except OSError:
+                        pass
+
+                if master_fd in rfds:
+                    try:
+                        data = os.read(master_fd, 4096)
+                        if data:
+                            # Strip title escape sequences
+                            data = TITLE_ESCAPE_PATTERN.sub(b'', data)
+                            os.write(sys.stdout.fileno(), data)
+                    except OSError:
+                        pass
+
+            # Stop remote client
+            remote_client.stop()
+
+            # Get exit status
+            _, exit_status = os.waitpid(pid, 0)
+            exit_code = os.WEXITSTATUS(exit_status) if os.WIFEXITED(exit_status) else 1
+
+    finally:
+        # Restore terminal settings
+        termios.tcsetattr(sys.stdin, termios.TCSADRAIN, old_tty)
+
+    sys.exit(exit_code if 'exit_code' in locals() else 0)
+
+
+def main():
+    """Standalone entry point"""
+    from .cli import main as cli_main
+    cli_main()
+
+
+if __name__ == '__main__':
+    main()

janus_remote-0.1.0/janus_remote.egg-info/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: janus-remote
+Version: 0.1.0
+Summary: Voice-to-text paste bridge for Claude CLI on remote SSH sessions
+Author: He Who Seeks
+License: MIT
+Project-URL: Homepage, https://github.com/anthropics/janus
+Project-URL: Repository, https://github.com/anthropics/janus
+Keywords: claude,voice,ssh,remote,paste,janus
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: websocket-client>=1.0.0
+Dynamic: license-file
+
+# janus-remote
+
+Voice-to-text paste bridge for Claude CLI on remote SSH sessions.
+
+Use your voice to interact with Claude CLI running on remote servers, with transcriptions pasted directly into the terminal - no window switching needed!
+
+## Installation
+
+```bash
+pip install janus-remote
+```
+
+## Requirements
+
+1. **Local Mac**: Janus Electron app running (provides voice recognition + WebSocket server)
+2. **SSH Config**: Port forwarding enabled (one-time setup)
+
+## SSH Setup (One-Time)
+
+Add this to your `~/.ssh/config` on your **local Mac**:
+
+```
+Host *
+    RemoteForward 9473 localhost:9473
+```
+
+Or for specific hosts:
+
+```
+Host myserver
+    HostName myserver.example.com
+    RemoteForward 9473 localhost:9473
+```
+
+This forwards the Janus WebSocket bridge (port 9473) to the remote server.
+
+## Usage
+
+On your remote server via SSH:
+
+```bash
+# Start a new Claude session with voice paste support
+claude-janus
+
+# Resume a previous session
+claude-janus --resume
+claude-janus -r
+```
+
+## How It Works
+
+```
+LOCAL MAC                           REMOTE SERVER (via SSH)
+┌─────────────────────┐             ┌─────────────────────┐
+│ Janus Electron      │             │ claude-janus        │
+│ (Voice Recognition) │             │ (This package)      │
+│         │           │             │         │           │
+│         ▼           │             │         │           │
+│ WebSocket :9473 ────┼─────────────┼───────► │           │
+│                     │  SSH Tunnel │         ▼           │
+│                     │             │ Inject into PTY     │
+└─────────────────────┘             └─────────────────────┘
+```
+
+1. Speak into your Mac's microphone
+2. Janus transcribes and sends via WebSocket
+3. SSH tunnel forwards to remote server
+4. `claude-janus` receives and injects text directly into Claude CLI
+
+## Features
+
+- **Zero latency feel**: WebSocket connection, no polling
+- **Background paste**: No window switching - text appears directly in terminal
+- **Multi-session support**: Run multiple `claude-janus` sessions on different servers
+- **Auto-reconnect**: Handles connection drops gracefully
+
+## Troubleshooting
+
+### "Bridge connection failed"
+- Ensure Janus Electron is running on your local Mac
+- Verify SSH port forwarding is configured
+- Check that port 9473 isn't blocked
+
+### "Could not find 'claude' binary"
+- Install Claude CLI: `npm install -g @anthropic-ai/claude-cli`
+- Or ensure it's in your PATH
+
+## License
+
+MIT
+
+## Author
+
+He Who Seeks

janus_remote-0.1.0/janus_remote.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+janus_remote/__init__.py
+janus_remote/cli.py
+janus_remote/pty_capture.py
+janus_remote.egg-info/PKG-INFO
+janus_remote.egg-info/SOURCES.txt
+janus_remote.egg-info/dependency_links.txt
+janus_remote.egg-info/entry_points.txt
+janus_remote.egg-info/requires.txt
+janus_remote.egg-info/top_level.txt

janus_remote-0.1.0/janus_remote.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

janus_remote-0.1.0/janus_remote.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+claude-janus = janus_remote.cli:main
+janus-remote = janus_remote.cli:main

janus_remote-0.1.0/janus_remote.egg-info/requires.txt

@@ -0,0 +1 @@
+websocket-client>=1.0.0

janus_remote-0.1.0/janus_remote.egg-info/top_level.txt

@@ -0,0 +1 @@
+janus_remote

janus_remote-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "janus-remote"
+version = "0.1.0"
+description = "Voice-to-text paste bridge for Claude CLI on remote SSH sessions"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "He Who Seeks"}
+]
+keywords = ["claude", "voice", "ssh", "remote", "paste", "janus"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "websocket-client>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/anthropics/janus"
+Repository = "https://github.com/anthropics/janus"
+
+[project.scripts]
+claude-janus = "janus_remote.cli:main"
+janus-remote = "janus_remote.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["janus_remote*"]

janus_remote-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+