convez.ai
AgenteProdutividadeIntermediário
dotdevdotdev

AgentWire

dotdevdotdev/agentwire-dev

Fale com seus agentes de IA de qualquer lugar via push-to-talk

Ver no GitHub
BomPluginScore · de 0 a 100

Controle por voz seus agentes IA (Claude Code) rodando em tmux, diretamente de telefone, tablet ou laptop via WebSocket. Push-to-talk com transcrição, TTS e visualização em tempo real da execução do agente.

Instalação

$npx convez-ai dotdevdotdev/agentwire-dev

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
23
Forks
6
Acompanhando
0
Saúde
100%
Último commit
há 1 semana
Versão
v1.85.0
Issues abertas
3
Contribuidores
2

Casos de uso

  • Controlar agentes de código Claude sem sair do sofá
  • Gerenciar múltiplos projetos via voz de dispositivos móveis
  • Executar comandos hands-free em sessões tmux remotas

Veredito

Ferramenta prática que resolve um problema real: acesso remoto ao Claude Code via voz com setup simples. Bem implementada, com segurança local pensada e TTS off-the-shelf funcional; ideal para workflows onde mobilidade importa.

README

A tradução para o português deste README ainda está na fila.


The Problem

You're on the couch. Your AI agent is on your workstation. You have an idea.

Old way: Get up. Walk to computer. Type.

AgentWire way: Pull out phone. Hold button. Talk. Done.


What It Does

Push-to-talk voice control for Claude Code or any AI coding assistant running in tmux.

Phone → AgentWire Portal → tmux session → Claude Code
 🎤        (WebSocket)         📺           🤖

From your phone, tablet, or laptop on your network:

  • Hold to speak, release to send
  • Watch agents work in real-time
  • Hear responses via TTS
  • Manage multiple projects simultaneously

Quick Start

# Install
pip install agentwire-dev

# Setup (interactive)
agentwire init
agentwire generate-certs

# Run
agentwire portal start
# Open http://127.0.0.1:8765 in Chrome — voice works immediately

Requirements: Python 3.10+, tmux, ffmpeg, Claude Code

Honest setup time: under a minute to a working voice portal with a genuinely good voice — Kokoro-82M runs on CPU out of the box (one-time ~200 MB model download in the background; the browser voice covers the wait). ~15 minutes for the full experience: cloned voices via a self-hosted TTS shim, Whisper-grade transcription, phone-from-anywhere (certs + token).

Network & trust model. The portal binds 127.0.0.1 by default — local only. To use it from your phone, set server.host: 0.0.0.0 in ~/.agentwire/config.yaml. Non-loopback binds require an auth token (auto-generated on first start; print it with agentwire portal token) — your phone prompts for it once, then remembers it. Origin checks reject cross-site browser requests on every bind. Still: keep it on a trusted LAN. Never port-forward it or run it on a public-facing VPS — for internet access use Cloudflare Tunnel + Zero Trust. Details in SECURITY.md.

macOS:

brew install tmux ffmpeg
pip install agentwire-dev

Ubuntu/Debian:

sudo apt install tmux ffmpeg python3-pip python3-venv
python3 -m venv ~/.agentwire-venv && source ~/.agentwire-venv/bin/activate
pip install agentwire-dev

WSL2: Same as Ubuntu. Audio is limited; use as remote worker with portal on Windows host.

tmux config matters. Default tmux has no mouse scroll, a tiny scrollback, and broken copy UX — see Recommended tmux config, or let agentwire init install it for you.


Features

FeatureDescription
Voice ControlPush-to-talk from any device on your network
Multi-SessionRun multiple agents on different projects simultaneously
Git WorktreesSame project, multiple branches, parallel agents
Remote MachinesSSH into GPU servers and talk to agents there
Worker OrchestrationSpawn worker panes, coordinate tasks, voice commands
Safety Hooks300+ dangerous commands blocked (rm -rf, force push, etc.)
TTS ResponsesAgents talk back via browser audio
Outbound ChannelsEmail (Resend) + SMS (Quo / OpenPhone) for cross-device notifications
Session RolesLeader/worker patterns for multi-agent workflows

How It Works

1. Create a session:

agentwire new -s myproject -p ~/projects/myproject

2. Open the portal: Visit http://127.0.0.1:8765 in Chrome (or your phone/tablet with LAN access configured)

3. Talk: Hold the mic button, speak your request, release. In instant mode the transcript appears for a quick glance — Enter sends it to Claude Code.

4. Listen: Agent responses are spoken back — Kokoro neural voice out of the box, or any TTS model behind a custom shim.


Multi-Agent Orchestration

AgentWire supports orchestrator/worker patterns for complex tasks:

# .agentwire.yml in your project (keep it gitignored — it's personal config,
# and tracked copies break worktree dispatch; agentwire adds it to .gitignore for you)
type: claude-bypass
roles:
  - agentwire
  - voice

Sessions can spawn workers:

agentwire spawn --roles worker  # Creates a worker pane
agentwire send --pane 1 "Implement the auth module"

Workers execute tasks autonomously while the orchestrator coordinates.


Safety

AgentWire blocks dangerous operations before they execute:

  • rm -rf /, git push --force, git reset --hard
  • Cloud CLI destructive ops (AWS, GCP, Firebase, Vercel)
  • Database drops, Redis flushes, container nukes
  • Sensitive file access (.env, SSH keys, credentials)
agentwire safety check "rm -rf /"
# → ✗ BLOCKED: rm with recursive or force flags

agentwire safety status
# → 312 patterns loaded, 47 blocks today

All decisions logged for audit trails.


Voice Configuration

Two tiers, both sides:

default (zero setup, what a fresh install gets): Chrome speech recognition in, Kokoro-82M out — a genuinely good neural voice (top of the TTS Arena at 82M params), 32 preset voices across 8 languages, pure CPU, identical on every OS. The model (~200 MB) downloads in the background on first portal start; browser speechSynthesis covers speech until it's ready (and remains the last-resort fallback). No GPU, no certs, no commands.

custom (bring your own model): any HTTP shim implementing the voice shim contract — ~30 lines wraps anything (Deepgram, whisper.cpp, an expressive emotion-tag model). Voice cloning, GPU engines, emotion control live here. The bundled servers are reference shims:

# ~/.agentwire/config.yaml
tts:
  backend: "custom"
  url: "http://localhost:8100"     # agentwire tts start (kokoro CPU / chatterbox GPU / qwen / zonos)
  options:
    backend: kokoro
stt:
  backend: "custom"
  url: "http://localhost:8101"     # agentwire stt start (moonshine ONNX, CPU)

Shims can declare capabilities (emotion tags, style instructions) via GET /capabilities — agentwire injects the shim's tool_prompt into the agent's say tooldef so agents actually use them.

Instant mode already needs nothing — just don't press the mic. Agent speech plays through the browser; mute the tab (or close it — with no browser connected, speech plays on local speakers, which you can silence at the system level).


CLI Reference

agentwire list                    # List sessions
agentwire new -s <name> -p <path> # Create session
agentwire kill -s <name>          # Kill session
agentwire send -s <name> "prompt" # Send to session
agentwire output -s <name>        # Read output
agentwire spawn --roles worker    # Spawn worker in current session
agentwire send --pane 1 "task"    # Send to worker
agentwire output --pane 1         # Read worker output
agentwire kill --pane 1           # Kill worker
agentwire say "Hello"             # TTS (auto-routes to browser)
agentwire alert "Done"            # Text notification (no audio)
agentwire listen start/stop       # Voice recording
agentwire voiceclone list         # Custom voices
agentwire machine add gpu --host 10.0.0.5 --user dev
agentwire new -s ml@gpu           # Create session on remote
agentwire tunnels up              # SSH tunnels for services
agentwire doctor                  # Auto-diagnose issues
agentwire safety status           # Check protection status
agentwire hooks install           # Install Claude Code hooks
agentwire network status          # Service health check

Documentation

Full reference: docs/wiki/INDEX.md

Quick links:


Community


License

Dual-licensed:


Ver o original no GitHub

Bom para

Relacionados