Instalar el CLI
El CLI de Almirant te permite conectar cualquier repositorio a tu proyecto con un par de comandos. Automatiza la creacion del archivo .mcp.json, copia los skill templates y configura la autenticacion sin necesidad de copiar y pegar claves manualmente.
Requisitos
- Node.js 18+ instalado
- Una cuenta en Almirant -- Crear cuenta
- Un proyecto creado -- Tu primer proyecto
Paso 1: Instalar el CLI
Instala el CLI de forma global:
npm i -g almirant
Verifica que la instalacion fue exitosa:
almirant --version
Paso 2: Iniciar sesion
Autentica tu cuenta via navegador:
almirant login
Este comando abrira tu navegador para completar el flujo OAuth. Al finalizar, tu API key se almacenara de forma segura en ~/.almirant/config.json.
Solo necesitas hacer login una vez. Las credenciales se reutilizan automaticamente en todos tus proyectos.
Paso 3: Vincular tu repositorio
Navega a la raiz de tu repositorio y ejecuta:
almirant link
El CLI:
- Usara las credenciales almacenadas en el paso anterior
- Te mostrara tus proyectos para que selecciones uno
- Generara el archivo
.mcp.jsoncon la configuracion correcta - Copiara los skill templates a
.agents/skills/ - Opcionalmente, configurara tu shell (PATH)
Si prefieres un flujo completo sin haber ejecutado almirant login previamente, usa almirant init en su lugar. Este comando te guia paso a paso por la autenticacion y configuracion en un solo flujo.
Paso 4: Verificar la conexion
Abre Claude Code en el directorio del proyecto y pide:
> Lista mis work items de Almirant
Si todo esta configurado correctamente, Claude respondera con los work items de tu proyecto.
Siguiente paso
Ya tienes tu repositorio conectado. Continua con Tu primer flujo AI para implementar una tarea completa usando IA desde tu IDE.
Para mas detalle sobre cada comando, consulta la Referencia del CLI.