Documentación / Primeros pasos

Tu primer proyecto

Abre una carpeta, deja que Yuli la indexe, decide la confianza y ejecuta la aplicación por primera vez.

Esta guía te lleva de un IDE recién instalado a tu aplicación corriendo, en cinco pasos.

1. Abre el proyecto

En el menú Archivo:

Opción Cuándo
Abrir proyecto… Tienes el proyecto en tu equipo.
Abrir carpeta… Quieres abrir cualquier carpeta.
Clonar repositorio… El proyecto está en GitHub, GitLab u otro remoto.
Proyectos recientes Ya lo abriste antes (Alt+3).
Nuevo proyecto desde plantilla… Empiezas uno nuevo.

Cada proyecto abre en su propia pestaña, debajo de la barra de título. Puedes tener varios abiertos y ver dos a la vez con Vista dividida: ver dos proyectos a la vez.

2. Decide la confianza

La primera vez, Yuli pregunta «¿Confías en este proyecto?».

Opción Qué hace Cuándo elegirla
Confiar Ejecuta Lombok y Maven/Gradle del proyecto para un análisis completo. Proyectos tuyos o de tu equipo.
Modo restringido No ejecuta código del repositorio. Analiza con lo que puede leer. Código que no conoces.

Puedes cambiarlo después en Opciones globales → Seguridad → Proyectos de confianza.

3. Deja que indexe

Yuli analiza el proyecto en segundo plano. Una barra fina en la parte superior del editor muestra el avance:

  1. «Preparando inteligencia de código…»
  2. «Indexando el proyecto…»
  3. «Resolviendo dependencias y analizando…»

Puedes seguir editando mientras tanto. Referencias, navegación y diagramas estarán completos al terminar.

Yuli detecta el tipo de proyecto: Maven, Gradle, Ant, Eclipse, npm o Cargo. Si falta un JDK, Maven o Gradle, te ofrece descargarlo.

4. Conoce la interfaz

Zona Qué hay
Izquierda El proyecto: archivos, Git y la configuración del agente.
Centro El chat con la IA.
Derecha El editor y sus pestañas.
Abajo Terminal, Ejecución, Problemas, Tests y Calidad.

Detalle en Las tres zonas.

5. Ejecuta

Tienes tres caminos:

  • En la pantalla de inicio, Ejecutar y probar.
  • Shift+F10 ejecuta la última configuración; Shift+F9 la depura.
  • Pídeselo al agente: «Arranca la aplicación y dime en qué puerto quedó».

La salida aparece en el panel Ejecución. Las líneas de stack trace del proyecto y cada Archivo.java:42 llevan al archivo y la línea.

Para crear o ajustar configuraciones (variables de entorno, perfiles de Spring, opciones de la JVM), usa Proyecto → Build, ejecución y depuración…. Ver Ejecutar y depurar.

Pruebas

  • Ctrl+Shift+F10 ejecuta todas las pruebas.
  • Ctrl+Shift+F11 las ejecuta con cobertura.
  • Ctrl+F9 construye el proyecto.

Los resultados aparecen en Tests y la cobertura en el margen del editor.

Siguiente paso

Conecta una IA y pide tu primera tarea. Una buena primera prueba:

«Explícame la arquitectura de este proyecto y dónde está la lógica de negocio principal.»