Repolode
Enviar
govijr

govijr/terminal-mac

Uma máquina virtual macOS que agentes de IA controlam por ferramentas MCP, com a tela exibida no terminal via gráficos do Kitty, Ghostty ou iTerm2.

Ver no GitHub
Estrelas
2,228
Forks
145
Issues abertas
1
Último commit
há 17 horas

O que é?

terminal-mac executa um sistema macOS convidado real em Apple silicon usando o framework Virtualization da Apple. Um app auxiliar dentro do convidado captura a tela e envia eventos de teclado e mouse, permitindo que agentes operem esse Mac separado sem mover o ponteiro do Mac físico nem acessar a área de transferência dele. O convidado tem seus próprios apps, arquivos e contas, sem herdar as sessões iniciadas no host.

Um visualizador no terminal transmite a tela do convidado em linha usando os gráficos do Kitty, Ghostty ou iTerm2 e permite digitar, clicar, arrastar, rolar e usar uma paleta de atalhos do Mac. Os comandos para agentes são disponibilizados como ferramentas MCP (screenshot, click, drag, scroll, type, key, status), junto com uma skill que descreve um ciclo de observar, agir e verificar. A CLI gerencia o download da imagem de restauração, a criação da VM, a inicialização e comandos de ciclo de vida, como pausar, retomar e parar.

O projeto está em uma fase inicial de release candidate. As permissões de Gravação de Tela e Acessibilidade do convidado precisam ser concedidas de forma interativa durante a configuração inicial, e a VM não vem isolada da rede por padrão.

Recursos principais

  • 01Executa um sistema macOS convidado real em Apple silicon, com seus próprios apps, arquivos e contas.
  • 02Transmite a tela do convidado em linha nos terminais Kitty, Ghostty ou iTerm2.
  • 03Disponibiliza screenshot, click, drag, scroll, type, key e status como ferramentas MCP.
  • 04A entrada do agente não move o ponteiro do host nem altera a área de transferência dele.
  • 05Instala com um script curl e baixa a imagem de restauração do macOS na primeira execução.
  • 06Oferece uma paleta de atalhos do Mac, acessada com Ctrl+G, para teclas que o terminal não consegue enviar diretamente.

Casos de uso

  • Permitir que um agente de IA use apps exclusivos do macOS sem assumir o controle do seu próprio desktop.
  • Testar softwares com interface gráfica do macOS em um Mac virtual isolado.
  • Acompanhar ou controlar um Mac virtual pelo terminal em sessões locais sem SSH.
  • Executar experimentos com agentes que usam o computador e precisam de um ambiente macOS descartável.

Início rápido

  1. 1

    Instale com o instalador curl do README (verifica o SHA-256)

  2. 2

    Siga a configuração guiada para baixar, instalar e inicializar um Mac virtual

    terminal-mac up
  3. 3

    Conecte um agente de IA por meio do MCP

    claude mcp add terminal-mac -- terminal-mac mcp

Antes de usar

  • Requer um Mac com Apple silicon executando o macOS 14 ou posterior.
  • É uma versão candidata inicial; os testes de aceitação do guest em um Mac limpo ainda estão pendentes.
  • Os lançamentos são autoassinados e não foram notarizados pela Apple.
  • O visualizador em linha funciona somente no Ghostty, Kitty ou iTerm2.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFerramentas de CLI e terminalApps open source para Mac

Tópicos

#macos#virtualization#computer-use#mcp#ai-agent#terminal#swift#apple-silicon

Perguntas frequentes

O que é terminal-mac?
Uma máquina virtual macOS que agentes de IA controlam por ferramentas MCP, com a tela exibida no terminal via gráficos do Kitty, Ghostty ou iTerm2. terminal-mac executa um sistema macOS convidado real em Apple silicon usando o framework Virtualization da Apple. Um app auxiliar dentro do convidado captura a tela e envia eventos de teclado e mouse, permitindo que agentes operem esse Mac separado sem mover o ponteiro do Mac físico nem acessar a área de transferência dele. O convidado tem seus próprios apps, arquivos e contas, sem herdar as sessões iniciadas no host.
terminal-mac é gratuito? Qual é a licença?
terminal-mac é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
terminal-mac ainda é mantido?
Manutenção ativa. O último commit de terminal-mac foi em 7 de nov. de 2026.
Para que posso usar terminal-mac?
Permitir que um agente de IA use apps exclusivos do macOS sem assumir o controle do seu próprio desktop. Testar softwares com interface gráfica do macOS em um Mac virtual isolado. Acompanhar ou controlar um Mac virtual pelo terminal em sessões locais sem SSH. Executar experimentos com agentes que usam o computador e precisam de um ambiente macOS descartável.
Como instalar terminal-mac?
Instale com o instalador curl do README (verifica o SHA-256) Siga a configuração guiada para baixar, instalar e inicializar um Mac virtual: terminal-mac up Conecte um agente de IA por meio do MCP: claude mcp add terminal-mac -- terminal-mac mcp
Onde consigo terminal-mac?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/govijr/terminal-mac

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados