instalar no macOS
Seu Mirror é uma única pasta local: sua identidade, memória, personas e jornadas. Instale uma vez e converse com ele pelo runtime que preferir. O Nautilus for Mirror, uma dessas opções, também pode criar o Mirror para você, sem terminal.
Você precisa do Node.js 24 ou mais recente, de uma conta no OpenRouter com pelo menos US$ 5 em créditos e uma chave de API, e de uma assinatura para o runtime de IA que vai usar.
node --version # precisa ser v24.0.0 ou mais recenteInstale ou atualize o Node.js em nodejs.org.
O Mirror Core é um pacote npm. Não há nada para clonar nem compilar. Rode mirror para conferir.
npm install -g mirror-mind
mirrorInicialize sua pasta, adicione sua chave do OpenRouter ao arquivo de configuração que o init criou e semeie sua identidade.
mirror init seu-nome
# adicione esta linha a ~/.config/mirror/env:
# OPENROUTER_API_KEY=sk-or-...
mirror seedSua pasta é ~/.mirror-minds/seu-nome/. A chave fica nesse arquivo, legível só por você. O Getting Started explica cada passo.
escolha como conversar com ele
Cada opção abaixo chega ao mesmo Mirror.
O Pi é o runtime recomendado: funciona com vários provedores de modelo. Instale, ligue ao Mirror uma vez, depois abra o pi em qualquer diretório e converse em linguagem natural.
curl -fsSL https://pi.dev/install.sh | sh
pi install "$(npm root -g)/mirror-mind"
piO Mirror se instala nesses agentes como plugin: suas skills, seus hooks e seu servidor MCP. Você continua no agente que conhece, agora com sua identidade, memória e jornadas. Ligue uma vez:
# Claude Code
mkdir -p ~/.claude/skills
ln -s "$(npm root -g)/mirror-mind/plugins/mirror-mind" ~/.claude/skills/mirror-mind
# Codex
codex plugin marketplace add "$(npm root -g)/mirror-mind"
codex plugin add mirror-mind@mirror-mindNa sessão seguinte, o Codex pede uma vez para confiar nos hooks do plugin; isso é esperado. Antigravity e Grok Build têm um ou dois passos próprios: o mirror init mostra os passos para os agentes que encontra, e o Getting Started lista todos.
Um app para macOS para trabalhar nas suas jornadas. O assistente instala o que falta, inclusive o próprio Pi, e conecta seus provedores. Se você ainda não tem um Mirror, ele cria um, sem terminal; esse Mirror é usado pelo app. Para usar o Mirror criado acima, escolha-o em Settings › Choose Mirror home…, e o app e o terminal passam a compartilhar o mesmo Mirror.
O app mostra o que a pasta contém antes de mudar qualquer coisa. Uma pasta criada por um Mirror anterior só é atualizada depois que o Mirror core faz um backup verificado, e um Mirror da era Python (antes do Core 0.32) não consegue mais abri-la. Se usar também um runtime de terminal com o app, use o Pi: um link do Claude Code registraria em dobro os turnos do próprio app.
Alpha. Feito para Macs Intel; Apple Silicon ainda não foi testado. Ainda sem assinatura nem notarização: na primeira vez, o macOS vai se recusar a abri-lo. Abra Ajustes do Sistema › Privacidade e Segurança e escolha Abrir Mesmo Assim.