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
- Local Mac: Darcy Electron app running (provides voice recognition + WebSocket server)
- 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 │
└─────────────────────┘ └─────────────────────┘
- Speak into your Mac's microphone
- Darcy transcribes and sends via WebSocket
- SSH tunnel forwards to remote server
claude-darcyreceives 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-darcysessions 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.