---
title: Instaladores Gerais
description: Arquitetura, detecção multiagente e automação dos instaladores oficiais da Siglata.
sidebar:
  label: Instaladores
  order: 3
---

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

| Pipeline                  | Ambientes Alvo                                                                   | Comando Shell POSIX                                        | Comando Windows PowerShell                               |
| ------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------- |
| **Codex e ChatGPT**       | Ambiente local `.codex`                                                          | `curl -fsSL https://www.siglata.com/install \| sh`         | `irm https://www.siglata.com/install.ps1 \| iex`         |
| **Universal Multiagente** | Claude Code, Cursor, Codex, VS Code, Hermes, Grok, OpenClaw, NanoClaw, OMP, Kiro | `curl -fsSL https://www.siglata.com/install/plugins \| sh` | `irm https://www.siglata.com/install/plugins.ps1 \| iex` |

---

## 1. Instalador Universal Multiagente (`/install/plugins`)

O Instalador Universal está em conformidade com a [especificação Agent Plugins](https://agent-plugins.org/) e o padrão [Agent Skills](https://agentskills.io/). 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:

  ```text
  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`.