4. La pantalla inicial

Al arrancar la app ves primero, unos segundos, una ventana pequeña de bienvenida con el logo, la versión y lo que está cargando (la interfaz y la comprobación de la licencia), con una barra y su porcentaje de avance. Cuando todo está listo se cierra sola y aparece la pantalla inicial; si la licencia no responde (por ejemplo, sin conexión), la pantalla inicial se abre igualmente a los pocos segundos. Nueva ventana no la muestra.

La pantalla inicial es la ventana que ves después. Se abre siempre con el mismo tamaño, ajustado a la página Proyectos, y no recuerda el tamaño que le des. Al abrir un proyecto la ventana se maximiza; al volver a la pantalla inicial o cerrar el proyecto, recupera ese tamaño y se centra.

A la izquierda hay una barra con:

• Proyectos — tus proyectos y los equipos disponibles (vista por defecto).
• Equipos y roles — en una sola pantalla con dos pestañas, tus equipos propios y los de la app (Equipos IA) y el catálogo de roles de la app (Roles) (ver Equipos y roles).
• Agentes — Claude Code y Codex: si están instalados, su versión y tu sesión.
• Licencia — el estado de tu licencia. Muestra un ! si no tienes licencia activa.
• Privacidad y datos — el texto completo de privacidad.
• Abajo: la versión instalada de la app, el estado de la licencia, el selector de idioma ES | EN y el botón de tema (sistema → claro → oscuro).
• Si hay una versión nueva de la app, aparece aquí un aviso (ver Actualizaciones).

Las cinco secciones comparten la misma cabecera, que se queda fija arriba al desplazarte: el título, debajo una frase que explica la sección y, a la derecha, el buscador (solo en Proyectos y en Equipos y roles) y los botones de la sección, con el principal al final. En una ventana estrecha, la cabecera pasa a varias filas.

En Inicio la página no se desplaza: la barra lateral se queda siempre en su sitio y solo se mueve el contenido de la derecha. Si la barra lateral no cupiera en una ventana muy baja, se desplazaría por sí sola, sin mover el resto.

Sección Proyectos

La sección es una sola columna que se desplaza entera.

Cabecera (se queda fija arriba al desplazarte)

• El título Proyectos y, debajo, «Abre un proyecto reciente o empieza uno nuevo con un equipo.».
• Buscar proyectos y equipos: escribe para filtrar a la vez los proyectos (por nombre o por ruta) y las tarjetas de equipos (por nombre, categoría, lema o descripción).
• Abrir ▾ — un menú con las formas de abrir un proyecto:
  • Abrir carpeta del proyecto… — abre una carpeta que ya es un proyecto (atajo: ⌘O en macOS, Ctrl+O en Windows/Linux). Si la carpeta no tiene todavía la configuración de un equipo, la app te ayuda a prepararla (ver Preparar una carpeta).
  • Unirse a un proyecto compartido (git)… — muestra, bajo la cabecera, el formulario para clonar un proyecto que otra persona compartió en un repositorio git (ver Colaboración). Si habías bajado por la pantalla, la app sube hasta el formulario y deja el cursor en el campo de la dirección.
  • Adoptar un proyecto existente… — incorpora a la app un proyecto con código desarrollado fuera de ella (ver Adoptar un proyecto existente).
• + Proyecto nuevo — es un atajo: no crea nada por sí mismo. Te lleva a los equipos, deja el foco en la primera tarjeta y señala la sección «Empieza con un equipo» con un contorno de color y el aviso «Elige un equipo y pulsa «Nuevo proyecto» en su tarjeta». La señal sale aunque los equipos ya estén a la vista y se retira sola a los 6 segundos o al elegir un equipo; si tienes activado «reducir movimiento» en el sistema, aparece sin animaciones.

Continúa donde lo dejaste

• Tus últimos proyectos recientes (hasta 4), en una lista: una fila por proyecto, como un archivo, con un icono de carpeta gris con la inicial del proyecto, su nombre y debajo su ruta (cortada con «…» si es larga), el equipo del proyecto, cuándo lo abriste por última vez (“hace 2 horas”, “ayer”…) y sus botones. La fila se resalta al pasar el ratón; al dejarlo encima se ven la ruta completa y cuándo lo abriste.
• El equipo se muestra como una etiqueta del color de su categoría: el icono de la categoría en un círculo claro, el nombre del equipo y su versión (por ejemplo, «Lyra v2.2.0»). Al pasar el ratón se ve el texto completo. Si el proyecto no tiene equipo identificable (sin configuración, o con un equipo que ya no está en tu lista de equipos), esa columna queda vacía. Si la ventana es estrecha, la fila sigue en una línea: se oculta «hace…» y la etiqueta del equipo se recorta.
• ↗ abre el proyecto en una ventana nueva; Abrir lo abre; × abre la ventana Quitar el proyecto, con su nombre y su ruta completa: Quitar de la lista lo quita de recientes y deja la carpeta en el disco; Quitar y borrar del disco… pide una segunda confirmación (¿Borrar la carpeta del disco?) y, con Mover a la Papelera (Papelera de reciclaje en Windows), manda la carpeta entera, con su código y sus documentos, a la Papelera del sistema, desde donde puedes recuperarla, y quita el proyecto de la lista. Si el proyecto está abierto en otra ventana o su carpeta ya no existe, la ventana lo avisa y solo deja quitarlo de la lista. Si el envío a la Papelera falla, se ve el motivo y no se borra nada. Cancelar, Esc o un clic fuera de la ventana no cambian nada.
• Los N proyectos → (si tienes más de 4) muestra todos en la misma pantalla; Ver menos vuelve a los 4 últimos. Mientras buscas, se muestran todos los que coinciden.

Empieza un proyecto con un equipo

• Junto al título, «Un equipo trabaja en todo el proyecto. Cada uno tiene su propio alcance.» y, a la derecha, Todos los equipos →, que lleva a Equipos y roles, pestaña Equipos IA (allí está el filtro por categoría y se crean, editan e importan los equipos).
• Un recuadro 💡 Consejo recomienda empezar con Asteroid (Ceres), la incubadora, si todavía no tienes clara la idea; su enlace Ver sus detalles abre la tarjeta de Ceres.
• Los equipos, en una sola rejilla de tarjetas compactas (hasta 4 por fila; con la ventana más estrecha, 3, 2 o 1): primero los de la app y después tus equipos (los que creaste, importaste o copiaste; aquí solo se eligen para crear un proyecto). Uno tuyo con errores de validación aparece atenuado y no se puede elegir, con un enlace a Equipos IA. El buscador de la cabecera filtra también estas tarjetas; si nada coincide, se ve «No se encontró ningún equipo. Revisa la carpeta team-templates de la app.». Importar un equipo no crea ni abre ningún proyecto.
• Una tarjeta por equipo, compacta, con:
  • arriba, una franja del color de su categoría con su icono y su nombre en mayúsculas (los tuyos, «COMET» o su categoría propia);
  • el nombre del equipo y su versión (por ejemplo «v1.5.0»; al pasar el ratón, «Versión del equipo: …»), con 🔒 si tu licencia no incluye el equipo. En los equipos de la app que no declaran versión propia es la de su firma (una fecha, como «v2026.10.02»); si no tiene versión conocida, no se muestra;
  • las caras de sus roles: un círculo por rol con sus iniciales, del color de su área (por ejemplo, azul para Producto y verde para Implementación; gris si la app no reconoce el área), solapadas, y el número de roles (por ejemplo «4 roles»). Al pasar el ratón se ven sus nombres;
  • una descripción de para qué es bueno el equipo (en un equipo importado sin esa descripción, «Importado ·» y su lema);
  • abajo, los botones Nuevo proyecto y Detalles. El borde se vuelve azul al pasar el ratón. Detalles despliega la tarjeta a todo el ancho, con fondo claro y borde del color de acento: la categoría y los idiomas en los que existe el equipo (por ejemplo «Supernova · ES · EN»; es información, no una selección), el resumen seguido de lo que no incluye, los roles como etiquetas del color de la categoría, qué parte del ciclo cubre (Visión, Definición, Construcción y pruebas, Despliegue y operación) y, en equipos importados, su versión y origen. Menos la vuelve a plegar.
• Un equipo que tu licencia no permite se ve igual, pero con 🔒 Nuevo proyecto: al pulsarlo se abre un diálogo que explica qué función de la licencia necesita, qué hace esa función y qué licencias la incluyen, con un botón Ver la licencia.

Equipos y roles

Desde esta entrada de la barra lateral creas y gestionas tus propios roles y equipos: el catálogo de roles, la pestaña Equipos IA y los editores con el agente. Tiene su propio capítulo: Equipos y roles: crea tus propios roles y equipos (capítulo 5).

Sección Agentes

Muestra una tarjeta por agente (Claude Code y Codex), una franja de resumen encima y, arriba a la derecha, el botón Comprobar de nuevo:

• Comprobar de nuevo vuelve a buscar los agentes y a comprobar sus sesiones (lo mismo que se hace al abrir Inicio y al volver a la ventana). Mientras tanto dice Comprobando…; las tarjetas conservan lo que mostraban hasta que termina.
• Franja de resumen: cuántos agentes están listos (instalados y con sesión). En verde, “2 de 2 agentes listos. Usan tu plan…”; en rojo, si falta instalar o iniciar sesión en alguno, con su nombre; en ámbar, si alguno usa API de pago (los chats consumen créditos).
• Cabecera de la tarjeta: el nombre del agente, una pastilla con el estado — Sesión iniciada (verde), Sin sesión o No instalado (rojo), API de pago (ámbar) — y la versión.
• Ruta del ejecutable, en una caja (se corta con «…» si es larga; al pasar el ratón se ve entera). Si no se encuentra: el aviso “No se encontró el ejecutable…” y el botón Elegir ruta para indicarlo a mano.
• Ruta elegida a mano: encima de la caja aparece Ruta manual. Si esa ruta ya no existe (se borró o se movió el archivo), un aviso ámbar “La ruta guardada ya no existe” la muestra; si la app encuentra el agente por su cuenta, lo usa y lo enseña debajo como Detectado automáticamente.
• Cambiar o quitar la ruta: Cambiar ejecutable abre el selector de archivos y sustituye la ruta (si cancelas, no cambia nada). Quitar ruta, solo cuando hay una ruta elegida a mano, la borra sin preguntar y la app vuelve a buscar el agente en las rutas habituales; la tarjeta, la franja de resumen y los chats usan el resultado al momento, sin reiniciar.
• Pegar ruta del ejecutable: debajo de la ruta, cada tarjeta tiene un campo siempre visible donde puedes escribir o pegar la ruta del ejecutable y pulsar Usar ruta (o Enter). Se ignoran los espacios y las comillas de los extremos y ~ es tu carpeta personal; la ruta debe ser absoluta (empieza por /, ~ o una letra de unidad como C:\), existir, ser un archivo y, en macOS y Linux, tener permiso de ejecución. Si no cumple, aparece un aviso bajo el campo y no se guarda nada; si cumple, aparece «Ruta guardada.» y la tarjeta muestra la ruta y su versión sin reiniciar. El campo muestra siempre la ruta elegida a mano (vacío si no hay), también tras usar Cambiar ejecutable o Quitar ruta.
• Al pie, de izquierda a derecha: Quitar ruta y Cambiar ejecutable (según el caso) y la acción de sesión: Cerrar sesión, o Iniciar sesión si no hay sesión.
• Datos de la cuenta, cuando hay sesión y el agente los informa:
  • Cuenta — el correo.
  • Organización — en Claude Code («—» si no hay).
  • Acceso — en verde, “Suscripción de Claude (claude.ai): usa tu plan” o “Suscripción de ChatGPT: usa tu plan”; en naranja, “API de pago por uso (…): cada mensaje se cobra aparte” si el agente usa una clave de API o un proveedor en la nube.
  • Plan — por ejemplo Claude Max, Claude Pro, ChatGPT Plus.
  • Activo hasta — en Codex, si la cuenta informa de una fecha futura.

Iniciar sesión desde la app:

• Claude Code: se abre el navegador en la página de Anthropic; inicias sesión, autorizas Claude Code, la página muestra un código, lo pegas en el diálogo y pulsas Continuar.
• Codex: se abre el navegador en la página de OpenAI; inicias sesión con tu cuenta de ChatGPT y autorizas Codex. El diálogo se completa solo cuando el navegador devuelve el control.

Sección Licencia

Ver el capítulo Licencias.