Xoral no seu terminal

O agente trabalha direto na pasta do seu projeto: lê arquivos, edita código, executa comandos e testes, pesquisa na web. Ele pede permissão antes de fazer alterações.

Instalação

macOS e Linux

curl -fsSL https://xoral.si/install | sh

Windows (PowerShell)

irm https://xoral.si/install.ps1 | iex

Ele é instalado em .xoral/bin, na sua pasta pessoal, e se adiciona ao PATH. Não é preciso ter permissões de administrador.

Primeira execução

Abra um terminal na pasta do projeto e execute xoral.
Digite /connect, escolha Xoral e cole sua chave de acesso.
Descreva a tarefa com suas próprias palavras, por exemplo: “descubra por que o teste em cart.test.ts está falhando e corrija”.

Você também pode definir a chave pela variável de ambiente XORAL_API_KEY. Enquanto o Xoral CLI estiver em beta fechado, as chaves são fornecidas mediante solicitação pelo support@xoral.si.

Modelos

Modelo	Indicado para
Xoral Forge	O principal, selecionado por padrão: escreve e corrige código, analisa erros.
Xoral Spark	Respostas rápidas e pequenas edições.
Xoral Titan	Tarefas difíceis: arquitetura, grandes alterações, revisões. Consome o limite 12 vezes mais rápido.

Troque de modelo com /models.

Comandos úteis

`xoral`	Abrir o agente na pasta atual
`xoral run "…"`	Executar uma única tarefa sem a interface
`xoral upgrade`	Atualizar o Xoral para a versão mais recente
`xoral --help`	Todos os comandos

Escreva regras específicas do projeto para o agente em um arquivo AGENTS.md na raiz do projeto.

O Xoral CLI é baseado no OpenCode e distribuído sob a licença MIT.