yxhpy/remotecc-claude-session

O que remotecc-claude-session faz?

Orquestração remota de sessões do Claude Code via SSH, tmux e rsync, com integração de skills do Codex.

Visão Geral

Este skill permite que agentes AI (como Claude Code, Cursor ou Codex) executem e gerenciem sessões de codificação remota de forma confiável. Ele usa SSH para conexão segura, tmux para manter sessões persistentes mesmo após desconexões, e rsync para sincronização eficiente de arquivos.

Como Funciona

1. Gerenciamento de Sessão: O skill cria ou conecta-se a sessões tmux existentes no servidor remoto. Cada sessão mantém o estado do agente (diretório de trabalho, histórico, etc.).
2. Execução de Comandos: Comandos são enviados remotamente via SSH e executados dentro da sessão tmux, garantindo que a saída seja capturada e retornada.
3. Sincronização de Arquivos: Utiliza rsync para espelhar diretórios de trabalho entre o host local e o servidor remoto, minimizando transferências desnecessárias.
4. Integração com Skills do Codex: O skill pode ser estendido com skills adicionais do Codex para funcionalidades especializadas (ex: análise de código, testes, deploy).

Plataformas Suportadas

• Claude Code (recomendado)
• Cursor
• Codex
• Qualquer agente AI com suporte a skills

Pré-requisitos

• Acesso SSH ao servidor remoto
• tmux instalado no servidor remoto (versão >= 2.0)
• rsync instalado em ambos os lados
• Chave SSH configurada para autenticação sem senha

Exemplo de Uso

# Conectar a uma sessão remota remota
remotecc connect --host usuario@servidor --session meu-projeto

# Executar um comando dentro da sessão
remotecc exec -c "npm test"

# Sincronizar arquivos (pull)
remotecc sync pull

# Sincronizar arquivos (push)
remotecc sync push

Variáveis de Ambiente

• REMOTECC_HOST - Host remoto padrão (ex: [email protected])
• REMOTECC_SESSION - Nome da sessão tmux padrão
• REMOTECC_RSYNC_OPTS - Opções adicionais para rsync

Integração com Codex Skills

Para usar skills do Codex com este skill, basta referenciá-los no arquivo de configuração:

# .remotecc/config.yaml
skills:
  - codex:analise-codigo
  - codex:testes-automatizados

Cada skill do Codex é executado dentro do contexto da sessão remota, com acesso aos arquivos sincronizados.

Boas Práticas

• Sempre encerre sessões com remotecc disconnect para evitar processos órfãos.
• Use remotecc sync status para verificar se os arquivos estão sincronizados.
• Para projetos grandes, configure REMOTECC_RSYNC_OPTS="--exclude=node_modules" para excluir diretórios desnecessários.

Solução de Problemas

• Erro de conexão: Verifique se o SSH está configurado corretamente e se a chave privada tem permissões adequadas.
• Sessão perdida: Use remotecc list para listar sessões ativas e remotecc attach para reconectar.
• Arquivos dessincronizados: Execute remotecc sync pull para trazer as últimas mudanças do servidor.

Licença

Este skill é distribuído sob a licença MIT.