almirant init

Configura la integracion MCP de Almirant para el repositorio actual. Es el flujo todo-en-uno: incluye autenticacion, seleccion de proyecto y generacion de archivos de configuracion.

Uso

almirant init

Que hace

1. Detecta el tipo de proyecto (Node.js, Python, etc.)
2. Verifica si ya existe un .mcp.json (si existe, pregunta si deseas continuar)
3. Busca credenciales almacenadas en ~/.almirant/config.json
   • Si existen, ofrece reutilizarlas
   • Si no, inicia el flujo de autenticacion
4. Permite elegir el metodo de autenticacion: OAuth via navegador o API key manual
5. Valida las credenciales contra el servidor
6. Muestra los proyectos disponibles para seleccionar
7. Genera el archivo .mcp.json en la raiz del repositorio
8. Copia skill templates a .agents/skills/

Flujo interactivo

$ almirant init

Almirant init

Detected project type: node
? Stored credentials found ([email protected]). Use them? (Y/n)
Using stored credentials (API: https://api.almirant.ai)

? Select project
  > Mi Proyecto (a1b2c3d4-e5f6-7890-abcd-ef1234567890)
    Otro Proyecto (f9e8d7c6-b5a4-3210-fedc-ba0987654321)
    Enter project ID manually

Almirant configured successfully.
- MCP config: /home/user/mi-repo/.mcp.json
- Skills dir: .agents/skills
- Skills copied: implement.md, review.md

Next: run your agent using the project MCP config.

Metodos de autenticacion

Si no hay credenciales almacenadas (o eliges no reutilizarlas), el CLI presenta dos opciones:

Metodo	Descripcion
OAuth browser flow (recomendado)	Abre el navegador para autenticar. Si falla, cae automaticamente a la opcion manual.
API key manual	Pega una API key existente directamente en la terminal.

info

Si ya usaste almirant login, tus credenciales se detectan automaticamente y no necesitas autenticarte de nuevo.

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

Cuando usar init vs link

• Usa init cuando es la primera vez que configuras Almirant en un equipo o maquina nueva y no has ejecutado login previamente.
• Usa link cuando ya tienes credenciales almacenadas (via login) y solo quieres vincular un nuevo repositorio rapidamente.