CLI Reference
El CLI de Almirant permite conectar repositorios a proyectos, autenticarse y configurar la integracion MCP desde la terminal.
Instalacion
npm i -g almirant
Verifica la instalacion:
almirant --version
Comandos
| Comando | Descripcion |
|---|---|
almirant login | Autentica via navegador y almacena la API key en ~/.almirant/config.json |
almirant link | Vincula el repositorio actual a un proyecto usando credenciales almacenadas |
almirant init | Configura Almirant MCP para el proyecto actual (flujo completo) |
Flags globales
| Flag | Descripcion |
|---|---|
--version, -v | Muestra la version del CLI |
--help, -h | Muestra la ayuda con los comandos disponibles |
Archivos generados
El CLI crea y utiliza los siguientes archivos:
| Archivo | Ubicacion | Descripcion |
|---|---|---|
config.json | ~/.almirant/config.json | Credenciales de autenticacion (API key, URL, usuario) |
.mcp.json | Raiz del repositorio | Configuracion MCP para conectar el agente al proyecto |
.agents/skills/ | Raiz del repositorio | Skill templates copiados para uso del agente |
info
El archivo ~/.almirant/config.json tiene permisos 600 (solo lectura/escritura para el usuario). Nunca compartas este archivo.
Flujo recomendado
Para la mayoria de los usuarios, el flujo recomendado es:
# 1. Autenticarse (una sola vez)
almirant login
# 2. En cada repositorio, vincular al proyecto
cd tu-repositorio
almirant link
Si prefieres un flujo todo-en-uno que incluya autenticacion y configuracion, usa almirant init.