almirant link
Vincula el repositorio actual a un proyecto de Almirant. Usa las credenciales almacenadas por almirant login para generar el archivo .mcp.json y copiar los skill templates.
Uso
almirant link
aviso
Requiere haber ejecutado almirant login previamente. Si no hay credenciales almacenadas, el comando mostrara un error y pedira que ejecutes almirant login primero.
Que hace
- Lee las credenciales de
~/.almirant/config.json - Valida que la API key siga siendo valida
- Obtiene la lista de proyectos disponibles
- Te permite seleccionar un proyecto (o ingresar un ID manualmente)
- Genera el archivo
.mcp.jsonen la raiz del repositorio - Copia skill templates a
.agents/skills/ - Opcionalmente, configura tu shell para incluir almirant en el PATH
Flujo interactivo
$ almirant link
Almirant link
Using credentials for: [email protected]
API: https://api.almirant.ai
Validating API key...
API key is valid.
? Select project
> Mi Proyecto (a1b2c3d4-e5f6-7890-abcd-ef1234567890)
Otro Proyecto (f9e8d7c6-b5a4-3210-fedc-ba0987654321)
Enter project ID manually
Project linked successfully.
- MCP config: /home/user/mi-repo/.mcp.json
- Skills dir: .agents/skills
- Skills copied: implement.md, review.md
Integracion con shell
Al finalizar, el CLI detecta tu shell (zsh, bash o fish) y ofrece agregar almirant al PATH:
Detected shell: zsh (~/.zshrc)
? Add almirant to PATH in ~/.zshrc? (y/N)
Si aceptas, agrega la siguiente linea a tu archivo de configuracion de shell:
# Added by Almirant CLI
export PATH="$HOME/.almirant/bin:$PATH"
Archivos generados
| Archivo | Descripcion |
|---|---|
.mcp.json | Configuracion MCP con la URL del proyecto y API key |
.agents/skills/ | Skill templates para el agente de IA |
Diferencia con almirant init
link es el comando rapido: asume que ya te autenticaste con login y va directo a la seleccion de proyecto. init es el flujo completo que incluye autenticacion (OAuth o manual) y configuracion en un solo paso.