Instaladores Gerais

Arquitetura, detecção multiagente e automação dos instaladores oficiais da Siglata.

A Siglata fornece dois pipelines canônicos de instalação hospedados diretamente no domínio de produção:

1. Instalador Universal Multiagente (/install/plugins)

O Instalador Universal está em conformidade com a especificação Agent Plugins e o padrão Agent Skills. Ele detecta automaticamente os agentes de código instalados no seu computador e configura tanto a Habilidade do Agente (Skill) quanto o servidor Model Context Protocol (MCP).

Ignorando Perguntas Desnecessárias (Smart Bypass)

Para garantir uma experiência sem atritos para usuários não técnicos:

• 1 Agente Detectado: Se você tiver apenas um agente suportado instalado (por exemplo, apenas o Cursor ou apenas o Codex), o instalador configura esse agente automaticamente sem fazer nenhuma pergunta.

• 0 Agentes Detectados: Se nenhuma pasta específica for encontrada, o instalador grava automaticamente na pasta de Habilidades Universais (~/.agents/skills) sem interrupções.

• Múltiplos Agentes Detectados: Se você possuir dois ou mais agentes (ex.: Cursor e Claude Code), o instalador exibe um menu numerado interativo:

  O Siglata detectou múltiplos agentes de código neste computador:
    [1] Claude Code
    [2] Cursor
    [a] Todos os agentes detectados (Recomendado)
  
  Em quais agentes você deseja instalar? [padrão: a]:

O Que É Configurado

Para cada agente selecionado:

1. Habilidades (Skills): Instala skills/siglata/SKILL.md e operations.md na pasta de skills do agente.
2. Servidor MCP: Configura o servidor MCP siglata apontando para https://www.siglata.com/v1/mcp com type: "streamable-http".

Escopo da Instalação

• Escopo Global (~/.<agente>/skills): O modo padrão. As habilidades e configurações MCP ficam disponíveis em todos os seus projetos.
• Escopo do Projeto (./.<agente>/skills): Quando executado dentro de um repositório Git, o instalador pergunta se deseja instalar globalmente ou apenas no repositório atual.

2. Executáveis Pré-compilados (Para Usuários Não Técnicos)

Para usuários em ambientes corporativos ou que preferem executáveis gráficos em vez de comandos de terminal, a Siglata fornece binários assinados:

• Windows: siglata-installer.exe — compilado via Bun (--target=bun-windows-x64) e assinado digitalmente com Azure Trusted Signing e carimbo de tempo RFC 3161.
• macOS: siglata-installer-darwin — compilado via Bun, assinado com Apple Developer ID e notarizado pelo Apple Gatekeeper.
• Linux: Binários ELF estáticos para x86_64 e aarch64.

3. Instalador Dedicado para Codex (/install)

O pipeline dedicado /install gerencia especificamente o ambiente local do OpenAI Codex ($CODEX_HOME ou ~/.codex):

• Mescla [mcp_servers.siglata] no config.toml de forma idempotente via parsing AST e awk.
• Configura o marketplace local e cache do plugin em ~/.codex/siglata-marketplace.
• Adiciona o bloco gerenciado de instruções da Siglata ao ~/.codex/AGENTS.md.
• Gera backup da configuração anterior em config.toml.siglata-backup.