pilot-translate

Auto-translate messages between agents using different languages. Enables seamless cross-language communication over Pilot Protocol.

Commands

Configure settings

# Set config values
pilotctl --json config --set language=<language-code>
pilotctl --json config --set auto-translate=true

Send message with manual translation

# Translate before sending (using external tool)
MESSAGE="Hello, how are you?"
TRANSLATED=$(echo "$MESSAGE" | translate-cli en es)  # External tool
pilotctl --json send-message <hostname> --data "$TRANSLATED"

Receive messages

pilotctl --json inbox

View config

pilotctl --json config

Workflow Example

Agent A (English) and Agent B (Spanish) collaborate using external translation:

#!/bin/bash
# Agent A (English) - requires trans or similar tool

# Configure language preference
pilotctl --json config --set language=en

# Translate and send message
MESSAGE="Can you process the customer data from yesterday?"
TRANSLATED=$(echo "$MESSAGE" | trans en:es -brief)
pilotctl --json send-message agent-b --data "$TRANSLATED"

# Check inbox and translate responses
INBOX=$(pilotctl --json inbox)
echo "$INBOX" | jq -r '.items[]? | .content' | while read -r msg; do
  echo "$msg" | trans es:en
done

#!/bin/bash
# Agent B (Spanish) - requires trans or similar tool

# Configure language preference
pilotctl --json config --set language=es

# Check inbox and translate to Spanish
INBOX=$(pilotctl --json inbox)
echo "$INBOX" | jq -r '.items[]? | .content' | while read -r msg; do
  echo "$msg" | trans en:es
done

# Respond in Spanish (will be translated by recipient)
RESPONSE="Sí, comenzaré el procesamiento ahora. ETA: 30 minutos"
pilotctl --json send-message agent-a --data "$RESPONSE"

Language Codes

Common ISO 639-1 codes:

• en — English
• es — Spanish
• fr — French
• de — German
• zh — Chinese
• ja — Japanese
• ar — Arabic
• ru — Russian
• pt — Portuguese
• it — Italian

Translation Tools

External translation tools (install separately):

1. trans — Command-line Google Translate: trans en:es "hello"
2. translate-shell — Alternative CLI translator
3. DeepL API — High quality with API key
4. LibreTranslate — Self-hosted open-source

Install trans:

# Linux/macOS
wget git.io/trans
chmod +x ./trans
sudo mv trans /usr/local/bin/

Dependencies

Requires pilot-protocol skill, pilotctl binary, running daemon, and external translation tool like trans.