Skip to main content

darcy-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

pip install darcy-remote

Requirements

  1. Local Mac: Darcy 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 Darcy WebSocket bridge (port 9473) to the remote server.

Usage

On your remote server via SSH:

# Start a new Claude session with voice paste support
claude-darcy

# Resume a previous session
claude-darcy --resume
claude-darcy -r

How It Works

LOCAL MAC                           REMOTE SERVER (via SSH)
┌─────────────────────┐             ┌─────────────────────┐
│ Darcy Electron      │             │ claude-darcy        │
│ (Voice Recognition) │             │ (This package)      │
│         │           │             │         │           │
│         ▼           │             │         │           │
│ WebSocket :9473 ────┼─────────────┼───────► │           │
│                     │  SSH Tunnel │         ▼           │
│                     │             │ Inject into PTY     │
└─────────────────────┘             └─────────────────────┘
  1. Speak into your Mac's microphone
  2. Darcy transcribes and sends via WebSocket
  3. SSH tunnel forwards to remote server
  4. claude-darcy receives and injects text directly into Claude CLI

Features

  • Sexy Terminal Banner: Claude + Darcy ASCII art on startup 🔮
  • Voice Paste: Speak on your Mac → text appears in remote terminal
  • Approval Overlay: Claude permission requests show on your local Mac overlay
  • Zero latency feel: WebSocket connection, no polling
  • Background paste: No window switching - text appears directly in terminal
  • Multi-session support: Run multiple claude-darcy sessions on different servers
  • Auto-reconnect: Handles connection drops gracefully

Troubleshooting

"Bridge connection failed"

  • Ensure Darcy 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

Metadata

Release files for darcy-remote 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for darcy-remote 1.0.4
File Size Uploaded Provenance Actions
darcy_remote-1.0.4.tar.gz 57.0 kB Without provenance Details for darcy_remote-1.0.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for darcy-remote 1.0.4
File Interpreter ABI Platform Actions
darcy_remote-1.0.4-py3-none-any.whl Python 3 none any Details for darcy_remote-1.0.4-py3-none-any.whl

Total release size: 116.3 kB

Release files / darcy_remote-1.0.4.tar.gz

Download URL darcy_remote-1.0.4.tar.gz
Size 57.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d34f518aecb08d87f2c8a86b95fc036fc81174b4f24745655fbaa72b3d474228
BLAKE2b-256 checksum
How to use checksums
ee531e50f780b4efb324174c5b2b643183035a27e6143995525b198ad37a3435
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / darcy_remote-1.0.4-py3-none-any.whl

Download URL darcy_remote-1.0.4-py3-none-any.whl
Size 59.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4a140025d21fe63bd651625e7f24de1e3615850b7514af62e68059fcf0da0830
BLAKE2b-256 checksum
How to use checksums
d5eabe271f38ac084bfcb9470022cbba0e0e354a509d594fb1a56613a8f78630
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Security for darcy-remote 1.0.4

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page