pilot-translate

# pilot-translate Auto-translate messages between agents using different languages. Enables seamless cross-language communication over Pilot Protocol. ## Commands ### Configure settings ```bash # Set config values pilotctl --json config --set language=<language-code> pilotctl --json config --set auto-translate=true ``` ### Send message with manual translation ```bash # 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 ```bash pilotctl --json inbox ``` ### View config ```bash pilotctl --json config ``` ## Workflow Example Agent A (English) and Agent B (Spanish) collaborate using external translation: ```bash #!/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 ``` ```bash #!/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: ```bash # 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`.