Instalar o CLI

O CLI do Almirant permite conectar qualquer repositório ao seu projeto com alguns comandos. Ele automatiza a criação do arquivo .mcp.json, copia os templates de skill e configura a autenticação sem a necessidade de copiar e colar chaves manualmente.

Requisitos

• Node.js 18+ instalado
• Uma conta no Almirant -- Criar uma conta
• Um projeto criado -- Seu primeiro projeto

Passo 1: Instalar o CLI

Instale o CLI globalmente:

npm i -g almirant

Verifique se a instalação foi concluída:

almirant --version

Passo 2: Fazer login

Autentique sua conta pelo navegador:

almirant login

Esse comando abrirá seu navegador para concluir o fluxo OAuth. Ao final, sua API key será armazenada com segurança em ~/.almirant/config.json.

informação

Você só precisa fazer login uma vez. As credenciais são reutilizadas automaticamente em todos os seus projetos.

Passo 3: Vincular seu repositório

Navegue até a raiz do seu repositório e execute:

almirant link

O CLI:

1. Usará as credenciais armazenadas no passo anterior
2. Exibirá seus projetos para que você selecione um
3. Gerará o arquivo .mcp.json com a configuração correta
4. Copiará os templates de skill para .agents/skills/
5. Opcionalmente, configurará seu shell (PATH)

informação

Se preferir um fluxo completo sem ter executado almirant login antes, use almirant init. Esse comando conduz você pela autenticação e configuração em um único fluxo.

Passo 4: Verificar a conexão

Abra o Claude Code no diretório do projeto e peça:

> Liste meus work items do Almirant

Se tudo estiver configurado corretamente, o Claude responderá com os work items do seu projeto.

Próximo passo

Seu repositório já está conectado. Continue com Seu primeiro fluxo de IA para implementar uma tarefa completa usando IA pelo seu IDE.

---

Para mais detalhes sobre cada comando, consulte a Referência do CLI.