Skip to Content
DocumentaçãoInstalaçãoMacos

Guia de Instalação para macOS - Synkra AIOS

🌐 EN | PT | ES

Pré-requisitos

1. Node.js (v20 ou superior)

Instale o Node.js usando um dos seguintes métodos:

Opção A: Usando Homebrew (Recomendado)

# Instale o Homebrew se ainda não estiver instalado
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Instale o Node.js
brew install node

Opção B: Usando o instalador oficial Baixe em nodejs.org 

Opção C: Usando Node Version Manager (nvm)

# Instale o nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
 
# Instale o Node.js
nvm install 20
nvm use 20

2. GitHub CLI

Instale o GitHub CLI para colaboração em equipe:

Usando Homebrew (Recomendado)

brew install gh

Usando MacPorts

sudo port install gh

Usando o instalador oficial Baixe em cli.github.com 

Instalação

Instalação Rápida

  1. Abra o Terminal

  2. Navegue até o diretório do seu projeto:

    cd ~/path/to/your/project

  3. Execute o instalador:

    npx github:SynkraAI/aios-core install

O Que o Instalador Faz

O instalador automaticamente:

  • Detecta o macOS e aplica configurações específicas da plataforma
  • Cria os diretórios necessários com permissões apropriadas
  • Configura caminhos de IDE para localizações do macOS:
    • Cursor: ~/Library/Application Support/Cursor/
    • Claude: ~/.claude/
  • Configura scripts shell com terminações de linha Unix
  • Lida adequadamente com sistemas de arquivos case-sensitive

Configuração Específica por IDE

Cursor

  1. As regras da IDE são instaladas em .cursor/rules/
  2. Atalho de teclado: Cmd+L para abrir o chat
  3. Use @agent-name para ativar agentes

Claude Code

  1. Os comandos são instalados em .claude/commands/AIOS/

  2. Use /agent-name para ativar agentes

  3. Use @agent-name para ativar agentes

Solução de Problemas

Problemas de Permissão

Se você encontrar erros de permissão:

# Corrigir permissões do npm
sudo chown -R $(whoami) ~/.npm
 
# Corrigir permissões do projeto
sudo chown -R $(whoami) .aios-core

Autenticação do GitHub CLI

Após instalar o GitHub CLI:

# Autenticar no GitHub
gh auth login
 
# Escolha o método de autenticação (navegador web recomendado)

Problemas de Path

Se os comandos não forem encontrados:

# Adicione ao ~/.zshrc ou ~/.bash_profile
export PATH="/usr/local/bin:$PATH"
 
# Recarregue a configuração do shell
source ~/.zshrc  # ou source ~/.bash_profile

Case Sensitivity

Os sistemas de arquivos do macOS podem ser case-insensitive por padrão. Se você tiver problemas:

  1. Verifique seu sistema de arquivos:

    diskutil info / | grep "File System"

  2. O Synkra AIOS lida automaticamente com sistemas de arquivos case-sensitive e case-insensitive

Atualização

Para atualizar uma instalação existente:

npx github:SynkraAI/aios-core install

O atualizador irá:

  • Detectar sua instalação existente
  • Fazer backup de quaisquer customizações
  • Atualizar apenas os arquivos alterados
  • Preservar suas configurações

Próximos Passos

  1. Configure sua IDE (veja configuração específica por IDE acima)
  2. Execute *help no seu agente de IA para ver os comandos disponíveis
  3. Comece com o Guia do Usuário
  4. Junte-se à nossa Comunidade Discord  para obter ajuda

Requisitos de Sistema

  • macOS 10.15 (Catalina) ou posterior
  • 4GB RAM mínimo (8GB recomendado)
  • 500MB de espaço livre em disco
  • Conexão com a internet para pacotes npm

Recursos Adicionais

LinuxTroubleshooting