Início Rápido

Instale o Spirit Agent, conecte um provedor e faça uma pequena edição aprovada.

Esta página leva você de uma instalação nova até uma alteração útil. As páginas seguintes cobrem todos os provedores e hosts; sem este caminho, essas páginas não têm onde se ancorar.

1. Instale o Desktop ou a CLI

Escolha um host. Eles compartilham o mesmo daemon local, então você pode adicionar o outro depois.

Baixe a versão para sua plataforma na página de download e abra-a.

macOS: .dmg (Intel ou Apple silicon)
Windows: instalador .exe (x64 ou ARM64)
Linux: .AppImage (x64 ou ARM64)

Detalhes: Instalar Desktop.

2. Abra um workspace

O agente lê e edita arquivos na raiz do workspace. Abra o projeto que você deseja alterar.

Use Abrir pasta do workspace na barra lateral e escolha uma pasta. Os workspaces recentes permanecem na lista.

3. Conecte um provedor

Você precisa de uma chave de API de um provedor que já usa. O Spirit armazena essa chave no chaveiro do sistema operacional (SpiritAgent).

Abra Configurações → Modelos.
Escolha um provedor e siga o assistente de conexão.
Cole a chave. Campos extras (região, site, endpoint do plano) aparecem somente quando o provedor precisar deles.
Escolha um modelo de chat como modelo ativo.

4. Peça uma pequena alteração e aprove-a

Permaneça no modo Agent e na aprovação padrão na primeira execução. Peça ao agente para ler um arquivo que você conhece e depois fazer uma pequena edição óbvia.

Exemplo:

Read README.md and add a one-line project summary at the top. Do not change anything else.

O agente lerá o arquivo, proporá uma edição e aguardará. Aprove a alteração do arquivo (e qualquer comando de shell) no prompt. Ao terminar, abra o arquivo e confirme a edição.

Esse é o ciclo completo: instalar → workspace → um provedor → ler → editar → aprovar. Todo o resto nesta documentação depende desse caminho.

Próximos passos

Instalar Desktop e Instalar CLI se você precisar de outro host ou uma versão fixada
Provedores para conectar outra casa, ou para verificar campos de site / plano / nuvem quando os modelos não foram importados