# 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):

trans — Command-line Google Translate: trans en:es "hello"
translate-shell — Alternative CLI translator
DeepL API — High quality with API key
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.

pilot-translate

pilot-translate

Commands

Configure settings

Send message with manual translation