docs

La barra lateral

Cuatro secciones, organizadas por lo que las cosas significan y no por su origen: lo que tienes abierto, los lugares que navegas, los pull requests que estás revisando y por dónde has pasado.

Archivos abiertos

El conjunto de trabajo: cada documento que has abierto explícitamente — desde el Finder, arrastrar y soltar, ⌘O, la línea de comandos o al conservar un archivo de una Ubicación. Plano, reordenable arrastrando, cada fila eliminable con la ✕ que aparece al pasar el cursor (o ⌫ en la fila seleccionada). Clic derecho en la cabecera de la sección para Cerrar todo.

Vistas previas

Un solo clic en un archivo dentro de una Ubicación y se renderiza al instante — y aparece en Archivos abiertos como vista previa: una única entrada en cursiva, siempre la última de la sección. Haz clic en otro archivo y la entrada de vista previa se reemplaza, así que navegar un árbol grande nunca acumula filas. Es la misma idea que las pestañas de vista previa de VS Code o el editor temporal de Xcode, con la misma cursiva.

Una vista previa se convierte en una entrada normal, fijada, cuando le muestras un compromiso más allá de leerla:

• Doble clic en el archivo del árbol, o en la propia entrada en cursiva
• Empezar a editar — entrar en el modo de edición o guardar la edición de un bloque la fija
• Mantener abierto en el menú contextual

Las interacciones de lectura — blame, historial de líneas, inspeccionar una imagen o un diagrama — deliberadamente nunca ascienden una vista previa. Si prefieres que cada clic abra los archivos del todo, cambia Al hacer clic en archivos de Ubicaciones en Ajustes.

Los repos remotos se previsualizan igual, en el mismo lugar. Navegar el árbol de un repo de GitHub, o seguir enlaces dentro de un documento remoto, pone la misma entrada única en cursiva en Archivos abiertos — con un icono de libro y una segunda línea owner/repo @ ref, ya que el archivo no está en tu Mac. Solo existe una vista previa por ventana, local o remota: previsualizar algo reemplaza lo que estuvieras previsualizando antes. Conservar un doc remoto (doble clic o Mantener abierto) es lo que lo archiva con su repo — pasa a la lista de fijados del repo bajo Ubicaciones. ⌘K abre fijando directamente, porque pegar una URL es intención explícita.

Cualquier fila de Archivos abiertos que viva dentro de una Ubicación abierta tiene Mostrar en su ubicación en su menú contextual — el salto de vuelta de «lo que estoy leyendo» a «donde vive».

Ubicaciones

Raíces navegables, vivan donde vivan. Dos clases comparten la sección, distinguidas por el icono:

Una carpeta local que es un checkout de git gana un chip de rama (glifo de rama + nombre); si su remoto está en GitHub, aparece además una pequeña marca de libro cerrado — pasa el cursor para ver de qué repo. Hacer clic en el chip de rama abre el menú de ramas y worktrees:

• Worktrees — cada worktree del repo, con una marca en el que corresponde a esta fila; elige otro para abrirlo como su propia Ubicación. PullMark nunca hace checkout ni cambia de worktree — abre la carpeta que ya está ahí.
• Ver una rama desde GitHub — lee los archivos de otra rama en remoto, sin tocar tu checkout. Una rama que ya tiene worktree local salta al worktree — lo local gana a lo remoto.
• Abrir en GitHub — el repo (en esta rama) en tu navegador.

En un repo remoto (icono de libro), el mismo chip lista ramas: Cambiar a vuelve a fijar la sesión en otra rama y, manteniendo ⌥, aparece Abrir la rama por separado para leer lado a lado. Explorar los archivos del repo… carga el árbol Markdown completo del repo. Los docs conservados del repo van encima del árbol, para que nunca se ahoguen bajo un repo grande; un doc conservado que ya es visible en el árbol simplemente se representa ahí. (Un doc que solo estás previsualizando aparece en Archivos abiertos, no aquí.)

Una carpeta cuya ruta deja de resolverse (un volumen desmontado, un worktree borrado) se atenúa con una insignia de interrogación en vez de desaparecer — revive por sí sola cuando la ruta vuelve.

Pull Requests

Cada PR abierto es un grupo: la fila de resumen (icono de estado + número de archivos Markdown modificados) y luego sus archivos Markdown modificados — un globo de comentario con contador marca los archivos con hilos de revisión sin resolver. Bajo tus PR abiertos, Solicitudes de revisión reúne los PR que esperan tu revisión, con un contador de no leídos que sigue visible incluso plegado (ocultable en Ajustes, y filtrable a solo los PR que tocan Markdown).

Iconos de estado en las filas de PR:

Marcadores por archivo dentro de un PR: círculo + (verde) para añadido, círculo − (rojo) para eliminado, círculo → para renombrado, círculo con lápiz para modificado.

Recientes

Archivos, carpetas y pull requests abiertos hace poco que no estén ya visibles arriba. Las entradas de PR llevan su icono de estado en vivo; un reciente cuyo archivo desapareció se atenúa (insignia de reloj) en vez de esfumarse y revive cuando la ruta vuelve — pensado para cambios de rama y volúmenes desmontados. Clic derecho en la cabecera para Vaciar recientes.

Quitar cosas

Pasa el cursor por cualquier fila de primer nivel para la ✕ — quita la fila de la barra lateral, jamás nada del disco ni de GitHub. ⌫ en una fila seleccionada hace lo mismo. Los archivos dentro del árbol de una Ubicación no tienen ✕: son contenidos de un lugar, no elementos de la barra lateral.

Glosario de iconos

El glifo de rama aparece solo en refs reales de git (chips, nunca como icono de carpeta) — una carpeta es una carpeta, un repo es un libro y una rama es una rama.