Install
curl -fsSL https://get.cotal.ai | shPara quem é
Cotal é um padrão aberto independente do provedor de modelo, utilizável entre máquinas e extensível, cujo propósito é fazer vários agentes de IA trabalharem juntos. Se você usa mais de um cliente entre Codex, Cursor, OpenCode, Gemini CLI e Windsurf e quer que eles compartilhem o mesmo conjunto de Agent Skills, ou troca com frequência de máquina e quer que um workflow parado no meio do caminho continue em outro host, esta é a ferramenta certa. Usuários de Claude Code usam o plugin cotal-skills fornecido oficialmente à parte.
Se você usa um único cliente e não precisa retomar tarefas entre máquinas, o ganho adicional é limitado. A página oficial não traz as seguintes informações; trate-as como não confirmadas antes de decidir: sistemas operacionais e versões compatíveis, se é necessária conta ou chaves, e em quais cenários claramente não serve. O único limite confirmável hoje: a instalação grava no diretório home do usuário e não precisa de sudo, o que normalmente implica um ambiente de terminal tipo Unix; a página oficial não diz isso explicitamente, e se funciona no Windows não está confirmado.
Sua primeira tentativa em 3 minutos
Só há um caminho principal recomendado; os comandos e caminhos abaixo vêm todos da documentação oficial.
Pré-requisitos: um terminal capaz de executar curl; pelo menos um entre Codex, Cursor, OpenCode, Gemini CLI ou Windsurf instalado nesta máquina (para Claude Code, veja a nota no fim desta seção).
Primeiro passo: executar o comando de instalação oficial. Um ponto para confirmar antes: este comando baixa um script remoto e o entrega ao shell para executar, grava conteúdo no seu diretório home e não precisa de sudo em nenhum momento; aceite isso antes de apertar Enter.
curl -fsSL https://get.cotal.ai | sh
Segundo passo: seguindo a orientação oficial, executar o comando de configuração após a instalação. Ele semeia uma persona padrão e instala os Agent Skills do Cotal em ~/.agents/skills.
cotal setup
Terceiro passo: abrir qualquer cliente compatível e lançar uma mini tarefa de baixo risco e somente leitura, por exemplo pedir ao agente que descreva quais categorias de conteúdo os Agent Skills recém-instalados contêm e para qual cenário cada um serve. Sinais de sucesso observáveis: o script de instalação termina normalmente e o comando de configuração conclui a semeadura da persona e a instalação dos skills. Como esses skills aparecem na interface de cada cliente e como a primeira conversa é roteada não está explicado na página oficial.
Nota secundária: o Claude Code usa o plugin oficial cotal-skills; os detalhes de instalação não são detalhados na página oficial.
Casos de uso
Caso 1: vários clientes compartilham o mesmo conjunto de skills. Cenário: você usa Cursor e Gemini CLI ao mesmo tempo e não quer manter uma cópia de skills por ferramenta. Procedimento: após a instalação e configuração acima, faça o agente de um dos clientes fazer algo pequeno com os skills recém-instalados, por exemplo resumir quais capacidades vindas do Cotal ele já tem disponíveis. Base: o projeto oficial fornece Agent Skills para esses cinco clientes e os instala em ~/.agents/skills. Como cada cliente carrega esse diretório e como os conteúdos se sincronizam não está explicado na página oficial; até aí vai o que se pode confirmar.
Caso 2: retomar em outra máquina um workflow parado. Cenário: um workflow se encerra no meio no notebook e você quer continuar no desktop. Procedimento: após repetir a mesma instalação no novo host, faça o agente retomar este run a partir do journal. Base: a documentação oficial diz que execuções de workflow registram cada passo em um journal e que um run parado pode ser retomado do seu journal em qualquer host. O comando exato de retomada e onde o journal fica guardado não são dados na página oficial; não chute caminhos por conta própria.
Limites de uso
Arquivos e comandos: há dois pontos de gravação confirmados: o script de instalação grava no diretório home (sem sudo) e o comando de configuração grava a persona padrão e ~/.agents/skills. Além disso, se em execução o agente lê ou grava outros arquivos, executa comandos ou acessa a rede não está explicado na página oficial; trate tudo como desconhecido e não presuma que essas operações não vão acontecer.
Ambiente de execução e clientes: a instalação depende do curl em um terminal; quanto aos clientes compatíveis, vale a lista oficial — a página oficial não afirma que só esses clientes funcionam, e se outros funcionam não está confirmado.
Restrições oficiais e pontos não confirmados: a página oficial não lista restrições de uso explícitas. Seguem sem confirmação: requisitos de sistema, como desinstalar, quais skills estão de fato incluídos, onde o journal fica guardado e se coleta dados. Diante desses vazios no uso, trate-os como desconhecidos e não preencha conclusões em nome do projeto.