TextMe

Visão Geral

njerschow/textme é um daemon local que faz a ponte entre iMessages recebidos (via Sendblue) e uma sessão do Claude Code na máquina do usuário. Números de telefone na lista de permissões podem enviar mensagens de texto, notas de voz, imagens e controlar o Claude através de operações de sistema de arquivos, execução de código e navegação de diretórios baseada em cd — transformando o telefone do usuário em um controle remoto para o Claude em seu laptop. Este é o contraponto de entrada para padrões de notificação de saída ([[sendblue-notify]]): textme é telefone → Claude; sendblue-notify é Claude → telefone.

Quando Usar Esta Habilidade

• Use quando o usuário disser "text Claude", "text my laptop", "drive Claude from my phone", "I want to send iMessages to Claude" ou "let me code from my phone".
• Use quando o usuário estiver longe da sua mesa e quiser iniciar, supervisionar ou interromper uma sessão do Claude via SMS/iMessage.
• Use ao configurar uma estação de trabalho headless de longa duração que o usuário deseja controlar remotamente enquanto viaja ou está longe do teclado.
• Combine com [[sendblue-notify]] para fluxo bidirecional — pings de conclusão de saída + comandos de entrada na mesma conta Sendblue.
• Não use para padrões de "me avise quando X terminar" apenas de saída. Isso é [[sendblue-notify]] e não precisa de um daemon.

Pré-requisitos

• Host macOS ou Linux que permaneça online (o daemon consulta o Sendblue continuamente).
• Node.js 18+.
• Uma conta Sendblue ativa com credenciais de API e um número de iMessage provisionado — configurado via [[sendblue-cli]] (sendblue setup, depois sendblue show-keys para exibir a chave/segredo da API).
• Claude Code instalado e autenticado no host (npm install -g @anthropic-ai/claude-code).
• Opcional: uma chave de API da OpenAI para transcrição de notas de voz com Whisper.

Como Funciona

Passo 1: Instale o daemon

git clone https://github.com/njerschow/textme.git
cd textme/daemon
npm install
npm run build
mkdir -p ~/.config/claude-imessage

Passo 2: Configure as credenciais e a lista de permissões

Crie ~/.config/claude-imessage/config.json:

{
  "sendblue": {
    "apiKey": "YOUR_SENDBLUE_API_KEY",
    "apiSecret": "YOUR_SENDBLUE_API_SECRET",
    "phoneNumber": "+1SENDBLUE_NUMBER"
  },
  "whitelist": ["+1YOUR_PHONE"],
  "pollIntervalMs": 5000,
  "conversationWindowSize": 20
}

O whitelist é o único portão de autorização entre um iMessage de entrada e a execução de código no host. Trate-o como um limite de segurança, não como uma preferência de UX. Adicione apenas números de telefone que o usuário controla; nunca adicione um número compartilhado, de trabalho ou familiar "por via das dúvidas".

Para transcrição de voz, opcionalmente adicione a .env no diretório do daemon:

OPENAI_API_KEY=sk-...

Passo 3: Execute o daemon

Para um teste rápido:

cd textme/daemon
npm start

Para operação persistente (recomendado assim que o usuário verificar o comportamento):

pm2 start dist/index.js --name textme
pm2 save
pm2 startup

Ou, no macOS, instale o serviço launchd:

./scripts/install-launchd.sh

Passo 4: Controle o Claude a partir do iMessage

Com o daemon em execução, um iMessage de um número na lista de permissões para o número de telefone do Sendblue chega ao Claude. Comandos integrados:

Qualquer outra coisa é tratada como um prompt do Claude e roteada para a sessão ativa.

Passo 5: Verifique antes de confiar

Antes de usar o textme em fluxos de trabalho não supervisionados, o usuário deve:

1. Enviar status do telefone na lista de permissões — deve receber uma resposta com o diretório + estado.
2. Enviar um comando benigno (pwd, ls) e confirmar que a saída chega.
3. Enviar algo de um número fora da lista de permissões e confirmar que ele é ignorado, não repetido.
4. Desconectar: matar o daemon e confirmar que as mensagens param de ser processadas (nenhum processo zumbi).

Se algum destes falhar, não ative o início automático do launchd / pm2.

Exemplos

Exemplo 1: Passeio pela configuração inicial

# 1. Certifique-se de que o CLI do sendblue esteja configurado e as credenciais funcionem
sendblue whoami

# 2. Obtenha a chave e o segredo da API do Sendblue (estes NÃO são o token de portador do CLI)

…