██████╗ ██████╗███╗ ███╗██╗ ██╗██╗ ██╗ ██╔════╝██╔════╝████╗ ████║██║ ██║╚██╗██╔╝ ██║ ██║ ██╔████╔██║██║ ██║ ╚███╔╝ ██║ ██║ ██║╚██╔╝██║██║ ██║ ██╔██╗ ╚██████╗╚██████╗██║ ╚═╝ ██║╚██████╔╝██╔╝ ██╗ ╚═════╝ ╚═════╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝
um gerenciador de sessão tmux entre dispositivos para agentes de codificação de IA
Gerencie seus agentes de programação de qualquer dispositivo —
até do celular.
Gerencie Claude Code, Codex, Cursor e outros agentes de programação em um único painel no terminal. Veja quais sessões aguardam sua resposta, alterne entre projetos e conecte-se de outro dispositivo pelo Tailscale.
// painel
Veja o que está em execução. Encontre o que precisa de você.
Cinco agentes rodando em paralelo em quatro projetos, codificados por cores por estado — ativo, inativo, precisa da sua opinião. O painel é atualizado à medida que cada sessão avança, e o painel Dispositivos mostra todas as outras máquinas em execução do ccmux em sua tailnet ao lado dele.
entre dispositivos
Comece em um host conectado, atenda em seu telefone e retorne à mesma sessão em seu laptop.
todos os agentes
Claude Code, Codex, Cursor e mais — cada projeto escolhe um e o TUI inteiro segue.
teclado primeiro
Pressione Enter na sessão desejada. Sem nomes tmux, não --resume <hash>, sem SSH-então anexe.
configuração guiada
Um curl, então ccmux setup. Passa pela sua tailnet via SSH ou Mosh.
// transferência
Inicie no seu Mac. Continue no seu telefone. Retome em seu laptop.
Reconecte-se ao trabalho que você já iniciou.
Inicie uma tarefa em um Mac mini sempre ativo ou em um host Linux. O agente corre até lá enquanto você se desconecta e continua seu dia.
Seu telefone vibra: Claude está fazendo uma pergunta. Você toca na notificação e está anexado. Você responde, bate Ctrl-b d, bloqueie o telefone.
Amanhã de manhã no trem, você abre seu laptop, digita ccmux e selecione a sessão remota para continuar de onde parou.
// gerar
Gerar de qualquer lugar.
Telefone na cozinha: inicie uma nova sessão de agente no Mac, na sua mesa. Abra o Projetos em qualquer dispositivo, pressione ne escolha o host — sua máquina local ou qualquer peer executando ccmuxd em sua tailnet. O daemon remoto cria o diretório e inicia o agente; ccmux SSH-conecta você. Você nunca digitou ssh.
// conversas
Todas as conversas. Um toque.
ccmux lembra seus threads Claude / Codex / Antigravity / Cursor / pi / Muse Code anteriores - classificados por tempo recente, prontos para serem retomados. Pressione 2 para a tela Conversas, Enter naquele que você deseja. O daemon retoma o agente com o ID de sessão correto. Você não digita claude --resume <hash> nunca mais.
// atalhos de teclado
Escolha uma sessão. Pressione Enter.
Tudo pode ser descoberto. Acertar ? em qualquer tela do mapa de teclado.
você não digita
você acertou
Suas sessões são executadas em tmux. Use o painel para o trabalho diário e os comandos tmux sempre que precisar.
// agentes
Escolha um agente para cada projeto.
Cada projeto escolhe seu próprio agente e se lembra dele. O painel, o daemon e o despacho vêm a seguir.
claudecodexagycursor-agentpigrokmuseArmazenado por projeto em .ccmux/agent. Padrão: Claude. Defina um padrão diferente em config.toml.
// mcp
Seu agente pode ligar para ccmux como uma ferramenta.
Conecte seu agente de codificação ao ccmux Servidor MCP para inspecionar sessões, ler notas do projeto e verificar o uso. Iniciar sessões e enviar pressionamentos de teclas exigem uma aceitação explícita.
lido
- lista_sessões
- painel_leitura
- lista_projetos
- lista_conversas
- get_usage
- lista_máquinas
- nota_leitura · notas_de_pesquisa
ato (aceitar)
- spawn_session
- spawn_bare_session
- chaves_de_envio
- kill_session
Oculto de tools/list até você passar --allow-mutate.
{
"mcpServers": {
"ccmux": { "command": "ccmux-mcp" }
}
}Um agente em seu laptop pode ler o que seu irmão no Mac mini está fazendo, iniciar um ajudante em outro projeto, recuperar um resultado e limpar - sem você entrar no SSH. CCMUX_HOST=mini:7474.
// servidor de desenvolvimento
Dev server no mini, visualizado de qualquer lugar.
Inicie seu aplicativo da web no host, compartilhe sua porta com o Tailscale Serve e abra o URL HTTPS impresso em seu telefone. Ambos os dispositivos devem estar conectados à sua tailnet.
no mini
npm run dev
tailscale serve 3000
no seu telefone
Safari
→ HTTPS URL
no laptop
Browser
→ same HTTPS URL
Use a porta que seu servidor de desenvolvimento imprime; 3000 é um exemplo. Veja o guia de visualização do telefone para configuração de HTTPS e configuração de host permitido.
// mais
E mais algumas coisas que o ccmux lida silenciosamente.
Recursos reativos que aparecem quando você precisa deles e ficam fora do caminho quando você não precisa deles.
moshi-hook.02Controles de sonoControle quando o host permanece acordado. O modo macOS padrão funciona com alimentação CA; o comportamento de fechamento da tampa requer configuração separada.03Descoberto automaticamenteInstale o ccmux em um novo dispositivo e ele aparecerá em todos os outros dispositivos em sua tailnet em segundos - sem configuração de host.04Notas nativas do terminalTodo .md arquivo na árvore do projeto, agrupado por pasta, renderizado em painel. Pesquisa Ripgrep. Nenhum serviço de sincronização.05Anexa sobre SSH ou MoshAlcance qualquer máquina em sua tailnet por via plana sshou fixe um host com mosh para que a conexão sobreviva ao roaming e ao fechamento da tampa. Detectado automaticamente por host.06Configuração guiadaccmux setup é um assistente interativo que verifica tmux / mosh / tailscale e se oferece para instalar o que estiver faltando. ccmux doctor verifica isso.Perguntas comuns
O que ccmux adiciona a tmux?
tmux mantém as sessões do terminal em execução após você desconectar. ccmux adiciona um painel para agentes de codificação, navegação em projetos, histórico de conversas e descoberta de sessão remota. Aprenda como gerenciar diversas sessões.
Os agentes funcionam no meu telefone?
Os agentes são executados em seu Mac ou host Linux. Seu telefone se conecta a esse host por meio de um cliente de terminal; o anfitrião deve permanecer acordado e online. Configure o acesso móvel.
Preciso de Tailscale para sessões locais?
Você pode gerenciar sessões em uma máquina localmente. Tailscale conecta seus dispositivos para descoberta e acesso remoto. Conecte uma segunda máquina.
ccmux inclui uma assinatura de IA?
ccmux pode ser baixado gratuitamente. Instale e faça login no agente de codificação escolhido separadamente; a assinatura desse provedor ou cobranças de API ainda se aplicam. Verifique os requisitos de instalação.
Ajude a melhorar o ccmux
Encontrou um bug, uma explicação confusa ou uma tradução que pode melhorar? Toda contribuição é bem-vinda. Abra uma issue ou envie um pull request.
// nunca pare de enviar.
Experimente em sua máquina
v0.5.0 foi lançado. macOS, Linux ou Windows via WSL2 — um curl e pronto. Homebrew também funciona.