// Documentación de Singularity
El editor de código
Abre, modifica y guarda los archivos de tus proyectos sin salir de Singularity. El editor se basa en CodeMirror 6 y cada archivo ocupa una única pestaña en el deck.
Abrir un archivo
Haz clic en un archivo en la vista Code del navegador. Aperture y los resultados que apuntan a una línea también pueden abrir directamente el archivo en el lugar adecuado. Desde una comparación de Git, el diff se abre en una pestaña dedicada: su copia de trabajo, a la derecha, es editable.
Un archivo corresponde a una pestaña file:<ruta> del deck. Si vuelves a abrir la misma ruta, Singularity trae al frente la pestaña existente en lugar de duplicarla. Las pestañas y los borradores sin guardar se restauran entre sesiones.

El editor
CodeMirror 6 ofrece resaltado de sintaxis según la extensión, números de línea, plegado de código, guías de sangría, emparejamiento y cierre automático de paréntesis, así como el resaltado de las apariciones de una palabra. El editor admite, entre otros, JavaScript y TypeScript, HTML, CSS, JSON, Python, Markdown, Go y Rust.
La selección múltiple y los cursores múltiples no están disponibles. Las funciones que dependen de un servidor de lenguaje se describen por separado en la documentación de LSP.
Guardar
Pulsa Cmd+S en macOS o Ctrl+S en Windows y Linux. Una modificación marca la pestaña como no guardada; el indicador desaparece cuando la escritura se completa correctamente. El borrador también se conserva en la sesión mientras difiera del contenido en disco.
La vigilancia del navegador actualiza el árbol cuando cambia el disco, y el editor detecta que un archivo abierto se ha eliminado cuando la ventana vuelve a primer plano. En cambio, no fusiona ni recarga automáticamente el contenido de un archivo abierto modificado por otro programa: guardar escribe el búfer actual. Comprueba el cambio externo antes de sobrescribir el archivo.
La barra de estado y el inspector
La barra situada sobre el contenido muestra la ruta espacio de trabajo › proyecto › carpetas › archivo y, a continuación, los símbolos actuales cuando un servidor de lenguaje los proporciona. El inspector del editor completa esta información con la posición línea/columna del cursor, el lenguaje detectado, el número de líneas, el tamaño y la codificación mostrada, actualmente UTF-8.
La codificación es informativa: todavía no existe un selector para cambiarla.
Buscar y reemplazar en el archivo
Cmd/Ctrl+F abre la búsqueda en el archivo activo; Cmd/Ctrl+H abre directamente el reemplazo. La barra ofrece distinción de mayúsculas y minúsculas, palabra completa y expresiones regulares, muestra el número de coincidencias y permite pasar al resultado anterior o siguiente.
Este comando se limita al archivo activo. Para buscar en todo el proyecto, usa la búsqueda global; el reemplazo en varios archivos no está disponible.
Editar desde la revisión
Un archivo abierto desde la pestaña Review es editable mientras el run conserve una ruta de worktree registrada: tus cambios se aplican entonces a esa copia de trabajo aislada. Sin una ruta de worktree utilizable, el archivo se muestra en solo lectura para evitar escribir en una ubicación ambigua.
El flujo de aprobación, solicitud de cambios y rechazo se detalla en La revisión de código de los runs.
Limitaciones conocidas
- No hay vista dividida del editor, minimapa, blame de Git en línea ni ruta de navegación (breadcrumbs) en la que se pueda hacer clic.
- No hay cursores múltiples, selección múltiple con Cmd+clic, sticky scroll ni alternancia del ajuste de línea con el teclado.
- No hay una paleta Cmd/Ctrl+P dedicada a los archivos; usa Aperture, el navegador o la búsqueda global.
- Los archivos de más de 5 MB se leen por bloques y permanecen en solo lectura.
- No hay selección de codificación, reemplazo en varios archivos ni resolución de conflictos con una modificación externa.