Usar la app

La página se abre en Eidos MD, la app de escritorio: descárgala, abre una carpeta y el proyecto está ahí. La CLI no sirve la página. La app de escritorio →

El banco de trabajo

El marco es el de VS Code. Un centro de comandos en la parte superior abre la paleta: vacía, lista lo que abriste hace poco y, según escribes, busca Blueprints (los planos), documentos, borradores, tareas, lienzos y archivos de assets por título, id y ruta (T-A7GJ encuentra la tarea, B-5KFM el Blueprint), y lo que eliges se abre en su página propia, no en el lector sobre una tabla; > lista todos los comandos que el anfitrión y cada plugin registraron, con su tecla. ⌘P la abre y ⇧⌘P la abre sobre los comandos; las dos son atajos de teclado, que se cambian en Hot keys como cualquier otro. A su lado hay flechas de atrás y adelante. Un comando Ir a muestra la actividad que contiene su destino (la vista Core del proyecto para una colección o un documento de nivel superior, la actividad de un plugin para sus páginas) y abre la barra lateral si está oculta. Cada actividad tiene un comando Enfocar (Enfocar Proyecto, Enfocar Backlog) que muestra su vista dondequiera que la pusiste y lleva el cursor a ella, y cada actividad con ajustes un comando Abrir los ajustes de … que va adonde va el elemento de ajustes de su menú contextual; cualquiera de ellos admite una tecla en Hot keys.

/ abre en Home, el Inicio que ordenas tú. Su cabecera es el nombre del proyecto: el producto que define (eidos setup --product, o el lápiz a su lado), y si no, el repositorio en el que está; la pestaña del proyecto en la app lleva el mismo nombre. Bajo la cabecera va la primera colección o el primer Blueprint que crear, mientras el proyecto lo necesita, después tus widgets en tu orden, y Novedades al final. Añadir widget, a la derecha de la cabecera, lista los widgets que no están en tu Inicio y añade al final el que eliges: Comprobación (los hallazgos, los errores primero), El proyecto (los Blueprints por colección, con los documentos y borradores contados) y, del Backlog, Asignado a ti y En el tablero, con los que añada un plugin. El menú de cada widget (su ⋯ al pasar el ratón, o un clic derecho) tiene Mover arriba, Mover abajo y Quitar del Inicio, y ⌥↑ y ⌥↓ mueven el widget que tiene el foco. Tu Inicio es tuyo, guardado en el local.yaml del proyecto; mientras no ordenes el tuyo ves el Inicio del proyecto, vacío salvo que lo fije quien edita el framework. Quien edita el framework lo fija con Usar como Inicio del proyecto en Añadir widget, el Inicio con el que empieza quien no tiene uno propio, y Volver al Inicio del proyecto deja el tuyo por ese. Un widget cuyo plugin está apagado no se dibuja y conserva su sitio, así que vuelve donde estaba.

Una barra de actividad en el borde izquierdo tiene primero una casa para Home y después un icono por vista de la barra lateral principal: primero la vista Core del proyecto (los documentos de nivel superior, las colecciones como un solo árbol de archivos y el grupo Records; bajo una línea, las vistas guardadas, los borradores y el grupo de cada otro plugin), después la actividad de cada plugin en el orden que fijes (Canvas, Comments, Backlog, Source control, Assets, Settings); el menú de la cuenta (Iniciar sesión, o tu cuenta, y la persona como quien actúas) y un engranaje están al pie. Una barra lateral auxiliar en el borde derecho y un panel bajo el área principal son filas de pestañas que un plugin rellena (el historial de un Blueprint, sus tareas y assets adjuntos, el Chat, el Terminal), ocultas hasta que se muestran. Cada sector se muestra, se oculta y se redimensiona como en VS Code (⌘B, ⌥⌘B, ⌘J, arrastrando su borde), y todo se recuerda por persona en local.yaml. Donde un plugin pone una vista es solo donde empieza: arrastra su icono o su pestaña a otro sector (el Chat al panel, el Terminal a la barra lateral principal), o haz clic derecho para Mover a, y se queda ahí en cada proyecto hasta que la devuelvas o ejecutes Restablecer la ubicación de las vistas. Haz clic derecho en la barra de título (Atrás y Adelante, la búsqueda, los botones de los sectores) para ver la barra de actividad, la barra lateral principal, el panel y la barra lateral auxiliar, cada uno marcado mientras se muestra, así que una barra de actividad oculta, con el menú de la cuenta y el engranaje al pie, vuelve con un clic. Las filas de una lista de la barra lateral toman tu propio orden: arrastra una adonde la quieras, con una línea que marca dónde cae, haz clic derecho en ella (o usa su ⋯) para Move up y Move down, o pulsa ⌥↑ y ⌥↓ mientras tiene el foco. Vale para los documentos de nivel superior, las colecciones y los borradores de la vista Core del proyecto; las páginas de las actividades Backlog y Comments; las vistas guardadas de una página; los lienzos; las carpetas de la actividad Assets; y los iconos de la barra de actividad. El orden de las páginas de las actividades es tuyo en cada proyecto, en preferences.yaml; el de las filas propias de un proyecto (sus documentos, colecciones y borradores, sus vistas, las compartidas incluidas, sus lienzos, sus carpetas) se queda con ese proyecto, en su local.yaml, y nunca se escribe en los archivos que el proyecto comparte. Los estados y los tipos conservan el orden que les dan los ajustes del proyecto, porque ese orden es compartido.

La vista Core del proyecto muestra el proyecto como un solo árbol de archivos. Cada colección es una carpeta, sus grupos son carpetas dentro de ella y cada Blueprint es una fila con solo su nombre, con un punto cuando la comprobación tiene algo que decir de él; una carpeta se abre y se cierra con un clic y recuerda cómo la dejaste. Pasa el cursor sobre una colección o un grupo para ver un + que crea un Blueprint ahí y un icono de tabla que abre su tabla (la de un grupo, filtrada por él); la carpeta de la tabla abierta se ilumina. Un clic con el botón central abre un Blueprint en una pestaña detrás, y un clic derecho ofrece el menú que su fila tiene en la tabla. La vista se abre en el Core (el núcleo) del proyecto, bajo una sola etiqueta: los documentos de nivel superior como filas, con el Vocabulary al final, después las colecciones y después el grupo Records. Le sigue el resto, cada grupo separado por su encabezado: las vistas guardadas de todas las colecciones en un grupo Views, los borradores como dos carpetas, Local (abierta) y Shared (plegada hasta que la abras), cada una con su +, y el grupo de cada otro plugin. Quien edita el framework puede listar el Vocabulary en los ajustes del Framework, para todo el proyecto, con Mover a los ajustes en su clic derecho, y devolverlo con Mover al Core en su clic derecho allí. El Core → Abre un Blueprint desde cualquier sitio (la búsqueda, un enlace, una pestaña) y el árbol despliega las carpetas que lo contienen, lo ilumina y se desplaza hasta él; Reveal the open file en Preferences → Workbench lo desactiva.

Buscar, la primera de las actividades hasta que la arrastras a otro sitio, es la búsqueda del centro de comandos abierta en la barra lateral principal (⇧⌘F): primero lo que coincide por título, luego cada mención en el texto con la coincidencia marcada. Pestañas: las páginas se abren como pestañas sobre el área principal, cada una con una marca que dice qué contiene (un archivo, una tabla, una página propia de un plugin). Un filtro o un lector sobre la página visible se queda en su pestaña. Cualquier otra página que abras va a la pestaña de vista previa, con su título en cursiva, que la siguiente página que abras ocupa, como las vistas previas de VS Code; edita la página, haz doble clic en su pestaña o en el enlace a ella, elige Keep Open en su menú o fíjala, y se queda. Desactiva Enable preview en Preferences → Workbench y cada página se abre en una pestaña propia. ⌘ y clic en un enlace o + abre una pestaña propia, fija una pestaña para conservar su página y cierra una con su ×, un clic con el botón central o su menú; al cerrar la última, el área principal queda vacía hasta que abras una página. Las pestañas abiertas se recuerdan para cada proyecto. Un clic con el botón central en un enlace, una entrada de la barra lateral, un resultado de búsqueda, una fila de una tabla o una tarjeta del tablero abre su página en una pestaña nueva, con el nombre de lo que pulsaste hasta que la página la nombra, y deja la página en la que estás como está. Un lector mostrado en un modal (un Blueprint, un borrador, una tarea, un paquete del Registro, un hilo de comentarios) tiene Abrir en una pestaña nueva y Abrir en esta pestaña antes de su ×. El modo enfoque, en Preferences → Workbench, muestra una página cada vez. Buscar en el archivo (⌘F) encuentra texto en la página o el archivo abierto, con cada coincidencia marcada, y Enter y ⇧Enter para recorrerlas.

Las colecciones como tablas

Cada colección es una tabla: una fila por Blueprint, las propiedades que le aplican como columnas, ordenable desde la cabecera, con una caja de búsqueda, un selector de columnas y un filtro por cada propiedad marcada como tal; una propiedad que además tiene activado Only show actively used in filters ofrece solo los valores que tiene un Blueprint de la colección. Un filtro con un valor lo dice, en cada página que tiene filtros: su botón nombra el filtro y el valor en el color de acento, y su × lo devuelve a todos. Un desplegable de diez opciones o más, sea de un filtro o de un campo, se abre con una búsqueda: escribe parte de un valor para acotar la lista y elígelo con las flechas y Enter. Una colección agrupada muestra su grupo como la primera columna, con las filas planas, ya que el árbol de la vista Core del proyecto es donde se anidan los grupos. Un punto al final de una fila marca un Blueprint sobre el que la comprobación tiene algo que decir. N empieza un Blueprint nuevo; todas las tablas de la página se ordenan igual, con sus filtros a la izquierda. En la tabla del Backlog, el encabezado del título tiene un segundo destino, ID, que ordena por id: en orden natural con el esquema de ids secuencial (T-2 antes que T-10, T-F36.2 antes que T-F36.10), y por el día en que se creó cada uno con uno aleatorio, cuyos ids no llevan orden. Todas las tablas tienen la misma caja de búsqueda, la primera entre sus filtros (la de una colección, la tabla, el tablero, los borradores y los hitos del Backlog, los borradores de Blueprints, los assets, Teclas rápidas, Vocabulary, Versions): deja las filas que tienen cada palabra que escribes, sin importar mayúsculas ni orden, en el id, el título o un valor que muestra la fila, y su × la vacía. En el tablero, la tabla y los borradores del Backlog, la tabla de una colección y los assets, los filtros (la búsqueda entre ellos como q) están en la dirección de la página, así que una tabla filtrada se puede guardar en marcadores, compartir, recargar y volver a alcanzar con atrás y adelante; cambiar uno no añade un paso al historial. Las demás tablas guardan los suyos mientras la página está abierta. Un botón de actualizar junto a la búsqueda vuelve a leer las filas de la tabla, para un cambio que no le ha llegado por sí solo; un cambio hecho en un modal sobre la tabla (el estado de una tarea puesto en su lector, por ejemplo) le llega sin él.

Iconos y colores

Haz clic derecho en una colección, un grupo o cualquier carpeta de la vista Project Core, o en un blueprint allí o en su tabla, y elige Cambiar icono…. El selector busca los iconos de Lucide por su nombre y por lo que muestran, y un conjunto de emoji por su nombre; también se puede usar cualquier otro emoji que escribas o pegues en la búsqueda. Debajo, elige un color. Cada elección se ve al instante, así que un icono y un color se ponen juntos, y Quitar (o Quitar icono en el clic derecho) quita los dos. El icono de una carpeta ocupa el lugar de su marca de carpeta, y su color tiñe la marca, el nombre y la línea junto a lo que contiene; el icono de un blueprint va antes de su nombre. La pestaña de un blueprint y la tabla de una colección llevan el mismo icono. Los iconos son del proyecto, se guardan en .eidos/plugins/eidosmd/settings.yaml y se confirman, para que todos vean el mismo árbol. eidos icons →

Vistas guardadas

Cuando el tablero, la tabla o los borradores del Backlog, o la tabla de una colección, están filtrados, Save as view en el ⋮ junto a su búsqueda guarda los filtros y el orden de la página con un nombre: Local, en esta máquina en local.yaml y nunca confirmada en git, o Shared, en .eidos/plugins/eidosmd/views.yaml y confirmada con el proyecto, para que todo el equipo la vea. La vista aparece al momento en la barra lateral principal en un grupo de las vistas de su página (Board views, Task views y Draft views en el Backlog; las de todas las colecciones en un grupo Views bajo el Core), una local con el icono de portátil, y abre esa página tal como se guardó; su dirección es la de la página con view=<id> (/p/backlog?view=V-7K2M&assignee=agent), y el orden va junto a los filtros como sort=<columna>, con un - delante de la columna para el sentido contrario. Si cambias los filtros o el orden de una vista que abriste, el ⋮ ofrece Update view para ella o Save as new view; haz clic derecho sobre una vista, o en su ⋯, para renombrarla, hacerla local o compartirla (Make local, Make shared; conserva su id, así que una página abierta en ella sigue en ella) o borrarla. My work, By status y By type del Backlog son las vistas con las que empieza todo proyecto. eidos views →

Haz clic en una fila para el lector sobre la tabla: las propiedades a la izquierda, que se quedan quietas mientras el cuerpo a la derecha se desplaza con su riel de contenidos, hallazgos y comentarios debajo, separados por una línea. Esc vuelve a la tabla; Abrir en esta pestaña abre el Blueprint como página propia. Abrir el lector es un paso en el historial de la página, así que Atrás lo cierra sobre la página de debajo, y Atrás desde una página a la que fuiste desde él vuelve a él, todavía abierto. Un documento de nivel superior, un borrador, una tarea y un asset se abren con la misma forma. Haz clic derecho en una fila, aquí o en cualquier tabla que liste cosas (los borradores, las tareas y los hitos del Backlog, los assets), para ver sus acciones: primero las formas de entrar, su id o su ruta para copiar, las salidas al archivo, y al final la que lo quita, que pregunta una vez.

Reading, Editor, Source

La página del lector se abre sobre una barra que se queda fija al desplazarte: el camino de vuelta y el id del Blueprint (specs / B-5KFM; en una tarea, su padre y su propio id, cada uno con el icono de su tipo, Backlog / T-PARENT / T-TASK, solo el padre y nunca la cadena que hay por encima), sin nada que guardar ni revertir en ella (Eliminar, Buscar en el archivo, Mover spec a… (con el nombre que la colección da a uno), que lleva el archivo a otro grupo de su colección con todos los enlaces siguiéndolo, y Mover a la colección…, que lo lleva a otra colección y a un grupo de ella después de que leas lo que cambia la mudanza, su ruta nueva, los enlaces que lo siguen y cada propiedad que se fija o se quita, están en el ⋮; un Blueprint arrastrado sobre la carpeta de otra colección o de otro grupo en la barra lateral pregunta lo mismo); debajo, el título con la ruta bajo él, y el id y la ruta se copian cada uno desde un enlace que aparece al pasar el cursor. Haz clic en el título o en el resumen para cambiarlo ahí mismo (Enter o un clic fuera lo conserva, Esc lo descarta); un resumen vacío ofrece Generate with AI, que pide al AI Agent la frase que lee el índice.

El lector tiene los tres modos de Obsidian, elegidos en el ⋮ junto al título (el que está en uso, marcado) y conservados de página en página durante la sesión. Un Blueprint y una tarea se abren en Editor, así que se puede escribir desde el primer clic; la preferencia Default view (view_mode en preferences.yaml) elige otro, y quien la puso en Reading o Source lo conserva. Reading muestra la página renderizada. Editor es un editor de markdown con la página renderizada mientras escribes: el bloque bajo el cursor se dibuja como se lee la página, con la sintaxis de una marca visible solo donde la toca el cursor, marcado por el color de acento en su borde, y el resto de bloques se dibujan; el archivo sigue siendo exactamente lo que escribiste; un + en un bloque vacío, o / al principio de él, abre un menú de bloques (encabezados, listas, una lista de tareas, una cita, código, una tabla, una regla, y lo que ofrecen los plugins: una imagen o un archivo de Assets, una tarea de Backlog); un bloque escrito muestra en su lugar el icono de su tipo (¶, H1, el de una lista), que lo convierte en otro tipo; una imagen pegada cae en la carpeta de assets y en el texto. [[ escrito en un bloque, o Enlace en el menú de bloques, abre un selector que busca los Blueprints, las tareas y los assets del proyecto, con las palabras escritas después de [[ acotándolo, y escribe el que eliges como un enlace markdown relativo al archivo, del tipo que sigue ⌘-clic y que eidos move mantiene. Una tabla se edita como una cuadrícula de sus celdas, cada una escrita con las teclas de markdown y la barra de formato: Tab, Enter y las flechas recorren las celdas y añaden una fila después de la última, ⌃⌥ con una flecha añade una fila o una columna junto a la celda y ⌃⌥⇧ con una flecha la mueve, los puntos de los bordes superior e izquierdo añaden una columna o una fila donde están, y una pastilla en una fila o una columna abre su menú (añadir, mover, alinear, vaciar, eliminar) o la arrastra a otro sitio; Tabla en el menú de bloques elige su tamaño en una cuadrícula, las filas pegadas desde una hoja de cálculo llenan las celdas, el asa de la tabla la abre como su markdown, y un cambio escribe solo lo que cambió, así que las barras de una tabla alineada se quedan en su sitio. Una selección muestra encima una barra de formato (Bold, Italic, Strikethrough, Inline code, Link y el tipo del bloque), que Show format toolbar en Preferences → General → Editing oculta. Un clic en un enlace edita su bloque; ⌘-clic (Ctrl-clic fuera de un Mac) lo sigue como en Reading. Source es el archivo como texto. Un salto de línea que escribes es un salto de línea cuando se lee la página, como Obsidian lee una nota, y una línea en blanco empieza un párrafo nuevo. Un clic derecho en un campo, también en los bloques del editor, muestra el menú del propio sistema, con sus sugerencias de ortografía.

En todos los modos las propiedades se editan en su sitio como campos tipados, como los muestra Obsidian: un desplegable donde una propiedad tiene opciones, píldoras para una lista (un título largo cortado con puntos suspensivos, entero al pasar el puntero), cada una añadida desde un desplegable que dice lo que añade (Añadir blueprint, Añadir responsable) y que se busca en cuanto ofrece diez o más, una casilla, un calendario para una fecha; una propiedad declarada que al archivo le falta está a un clic, listada por su nombre (nunca el id que el archivo ya lleva, que muestra la barra), y una que pertenece a una herramienta se muestra bloqueada. Guardar escribe el archivo en el estilo de la casa, aplica las reglas al guardar del Linter y ejecuta la comprobación sobre él. El mismo menú abre el archivo en cada editor externo que listaste en Preferences, un Abrir en por editor con su nombre (Abrir en VS Code), o lo muestra en el Finder; la paleta también tiene Abrir el proyecto en Finder y Abrir el proyecto en cada editor, para la carpeta entera del proyecto.

Guardar, como en VS Code

Un Blueprint, un documento de primer nivel, una tarea del Backlog y un lienzo se editan en vivo, sin Guardar: el archivo se escribe cuando dejas de escribir y cuando lo dejas. Cada página abierta en el archivo, en esta ventana o en otra, ve tus ediciones mientras las escribes, y un cambio que escribe un agente, la CLI o git llega a cada página sin recargar. Los cambios se combinan a medida que se hacen, también dos que tocan las mismas palabras, así que un archivo en vivo nunca muestra un conflicto; un cambio de fuera de la app que cae en el bloque que tienes abierto se marca Cambiado fuera de la app, con Conservar y Revertir. Deshacer y rehacer (⌘Z, ⇧⌘Z, y Ctrl+Y fuera de un Mac) solo deshacen las ediciones hechas en esa página. Si la página pierde el servidor de la app dice Sin conexión, conserva lo que escribes y lo combina y lo escribe cuando el servidor vuelve. En un proyecto de Eidos online lo mismo vale para todos los que están en él.

Todo lo demás, un borrador, un borrador de tarea, un registro guardado como archivo y un archivo que la página no puede mantener en vivo (uno que retiene un merge o un rebase de git, o uno que tiene abierto otro servidor de Eidos en esta máquina), se guarda como guarda VS Code. Una edición se queda en la página hasta que se guarda, como VS Code guarda los cambios de un editor: con el guardado automático, un segundo después de que dejas de escribir salvo que elijas otra cosa, o con Guardar de Archivo (⌘S, o Ctrl+S fuera de un Mac, para el editor que está delante) y Guardar todo (⌥⌘S, o Ctrl+Alt+S). Ningún editor muestra un botón de Guardar ni de Revertir: Guardar, Guardar todo y Revertir archivo están en el menú Archivo de la app, encabezan el menú que abre un clic derecho en la barra de arriba, y están en la paleta. Mientras un elemento tiene cambios, su título y su pestaña llevan un punto, y Revertir archivo (o Revertir los cambios en el ⋮) devuelve lo que tiene el archivo. Deshacer y rehacer (⌘Z, ⇧⌘Z, y Ctrl+Y fuera de un Mac) recorren lo que hiciste desde que abriste el elemento, también a través de lo guardado.

Una edición sin guardar se queda con su pestaña: si vas a otra parte, el elemento sigue en su propia pestaña, la página a la que fuiste se abre a su lado, y al volver encuentras la edición donde la dejaste. Cerrar su pestaña o su modal, cambiar a otro modo o recargar pregunta Guardar, No guardar o Cancelar, una sola vez por todo lo que está sin guardar. Un guardado que falla conserva la edición y dice por qué. Cuando el archivo cambia en el disco mientras está abierto (un agente, la CLI, git, otro editor), un elemento que no has editado toma el cambio en su sitio y no se escribe nada. Un elemento con una edición la conserva, y su siguiente guardado se combina con el cambio, así que tu edición y la suya quedan las dos en el archivo. Un guardado que no se puede combinar se rechaza y se muestra como conflicto: cuando los dos lados cambiaron las mismas palabras, durante un merge o un rebase de git (incluido un pull desde Source control), en un archivo con marcadores de conflicto o en un archivo vaciado desde fuera. El elemento dice entonces que el archivo cambió, y el guardado automático te espera: Recargar toma el archivo y descarta tu edición, y Quedarme con lo mío escribe lo tuyo encima en el siguiente guardado. Una tarea movida a otro id o a otro sitio, un borrador movido entre compartido y personal, y un registro con un id nuevo no se combinan. La combinación es de la app: un guardado desde la CLI se rechaza si el archivo cambió debajo de él, como antes, y cuando dos servidores de Eidos tienen abierto el mismo proyecto en una máquina, solo combina el primero. Un archivo que cambió sin ninguna app abierta se combina la próxima vez que la app lo lee o lo guarda.

El guardado automático es una preferencia (Preferences → General), con los cuatro ajustes de VS Code:

Ajuste	Qué hace
Tras una espera (el predeterminado)	Se guarda pasada la espera del guardado automático (1000 milisegundos salvo que pongas otra) desde el último cambio.
Desactivado	Un editor con cambios solo se guarda con Guardar o Guardar todo; su pestaña conserva el punto y cerrarla pregunta.
Al cambiar el foco	Se guarda cuando el editor pierde el foco: haces clic en otra parte de la página, abres otro elemento, cambias de pestaña o sales de la ventana.
Al cambiar de ventana	Se guarda cuando la ventana pierde el foco.

Con el guardado automático activado, cerrar una pestaña o salir guarda lo pendiente en lugar de preguntar. Un guardado que cambia el nombre del archivo (el título nuevo de una tarea) lleva al lector al nombre nuevo, y salir enseguida nunca lo pierde ni te hace volver. Un guardado escrito tal como se envió nunca hace que la página vuelva a leer el archivo: la página reconoce su propio guardado cuando el cambio vuelve del disco, mientras que un cambio de cualquier otro se muestra al momento. Un guardado combinado se vuelve a leer, así que tu siguiente guardado se hace sobre el archivo combinado.

Un bloque de código marcado con un lenguaje (```ts, ```yaml, ```bash y el resto de gramáticas de Shiki) se colorea con los colores del tema en Reading, en los bloques dibujados del editor y en cualquier otro sitio donde la página muestra markdown; un bloque sin lenguaje queda sin color. Un bloque marcado como mermaid se dibuja como su diagrama, con los colores y la fuente de la página, y se vuelve a dibujar cuando cambian el tema o el lado claro u oscuro. El archivo conserva el texto: en el editor, un clic en el diagrama lo abre, Diagrama en el menú de bloques inserta uno, y un bloque que no se puede analizar muestra su texto con el error de Mermaid debajo. Exportar a PDF…, en el ⋮ de un Blueprint, un documento, un borrador o una tarea, escribe el archivo abierto como PDF, con o sin su título y sus propiedades, con el tamaño de página, la orientación, el margen y la escala que elijas; la app pregunta dónde guardarlo.

Borradores

Un Blueprint puede empezar antes de pertenecer a una colección: el botón Draft del formulario New (New spec, New video: con el nombre de la colección elegida), Shared o Local en su menú, conserva el archivo con la CLI, compartido con el proyecto o local, fuera de todo índice y comprobación hasta que Publish lo mueve a su colección bajo las reglas de new. Los borradores tienen un grupo en la vista Core del proyecto y una página propia; empezado desde ahí (el + del grupo, el New de la página) el formulario es New draft, cuyo Create draft y Enter conservan el archivo como borrador, nunca como Blueprint. eidos draft →

Hacer crecer el framework mientras trabajas

La organización se gana, no se prepara antes. Quien edita el framework (en un proyecto que no marca a nadie, todos) añade lo que el trabajo pide donde está el trabajo, y el framework lo sigue:

New collection, el + del grupo Collections: un nombre, la palabra para cada uno de sus elementos leída de él, y un template inicial con una sola sección Intent obligatoria. La fila de cada colección muestra New y esa palabra al pasar el puntero.
New group… en el selector de grupo del formulario New, aunque la colección aún no se agrupe: la agrupación empieza con la etiqueta Group, su propiedad declarada, y los Blueprints de la raíz de la colección pasan al grupo.
Promote to framework, el + junto a una propiedad que el framework no declara: el formulario de propiedad se abre ya relleno, con el tipo leído del valor. Una propiedad propia es un aviso hasta que se promueve o se quita, salvo que los ajustes del Health Check desactiven Warn on unknown properties.
Una sección que el template ofrece y a un Blueprint le falta aparece en gris en su sitio, con un + que la añade. Los templates marcan sus secciones Required en el editor, y un Blueprint nuevo empieza solo con ellas.

Ajustes

El engranaje abre Settings como vista de la barra lateral, con sus grupos nombrados como VS Code nombra sus ámbitos: User (Account, mientras has iniciado sesión, y This server, para quien es dueño de un servidor de equipo; Preferences, Appearance, Hot keys, tuyos en cada proyecto) y Workspace (los de este proyecto: Framework, Health Check con los hallazgos de la comprobación y sus arreglos, Corregir todo lo que se puede arriba, que aplica todos los arreglos a la vez después de listarlos y deja un cambio de id, un archivo renombrado o un valor quitado hasta que lo marques, contando los arreglos en una barra mientras se aplican, y una pestaña Settings para la estrictez y las reglas de secciones; Users, Built-in plugins, Community plugins, Registry). Framework abre el documento del Framework (el marco) como formularios (Project, Folders, Templates, Properties, Vocabulary, Roles, Me, cada página un borrador hasta Save to Framework), y mientras una de sus páginas está abierta Settings se vuelve la barra lateral propia del Framework, sus páginas bajo un camino de vuelta a la página de la que vienes. En Users, New role… al pie del Role de una persona abre Roles, que edita un rol como lo escribe el estándar: quién es, las pautas a las que se ajusta un agente y la calibración. Crear con IA ahí te hace uno: di para quién es el rol, luego Preguntar a tu IA (el Agente de IA, en una sesión propia) o Copiar el prompt para cualquier IA, y pega la respuesta; el rol se crea con un nombre que ningún otro rol tiene, y puedes cambiarlo una vez creado. Me, en el Framework, muestra las pautas de tu rol con sus valores por defecto, y lo que escribes para una se vuelve una línea bajo Calibration en tu me.md. Los ajustes de un plugin se abren desde el engranaje al pie de su propia vista o desde el engranaje de Plugins, y Settings muestra entonces solo las secciones de ese plugin, bajo un camino de vuelta a la página desde la que los abriste, que se mantiene cuando pasas a los ajustes de otro plugin; su página en esta documentación es el botón Docs en la cabecera de los ajustes del plugin. Un ajuste que cambias en cualquiera de estas páginas muestra su nuevo valor al instante y lo conserva mientras se guarda; solo vuelve atrás si el guardado falla, y una notificación dice por qué.

Las páginas del Framework, Users y los ajustes compartidos de cada plugin los cambia un editor del Framework. Para cualquier otra persona se pueden leer pero no cambiar, y Editar en la cabecera de la página propone hacer editor al usuario como quien actúas; una vez que lo eres, la página se edita directamente. Un proyecto que no marca a nadie como editor deja que todos lo sean. Un ajuste que se guarda en esta máquina (local) nunca se bloquea.

Users: en un proyecto de Eidos online, primero sus Miembros, cada uno con su acceso; después las personas que trabajan en el proyecto (nombre, @alias, rol, email, un selector Acceso con Ninguno, Editor o Propietario, y un interruptor Agente para un agente de IA que comenta como sí mismo), guardadas en settings.yaml; eidos users las lista, eidos users add añade una y eidos users set fija el acceso. Un propietario siempre es editor, solo un propietario concede o quita Propietario, y el avatar y las @menciones de un propietario llevan una estrella. El usuario como el que actúas se distingue dondequiera que se le nombre: su avatar lleva un anillo del color de acento, y su nombre, sus píldoras de asignado, las @menciones a él y su fila aquí se marcan con ese color. El usuario propio de un plugin, el @agent del Agente de IA, aparece como del plugin: su nombre, alias y rol son de solo lectura, no tiene email ni acceso, y se queda mientras el plugin esté activo. Acting as elige como quién firma comentarios esta máquina, solo entre las personas: un agente actúa desde la terminal con --as, así que no se ofrece ahí. Atribución, no autenticación.
Hot keys: una tecla, o Asignar tecla en una fila que no tiene, abre un editor de teclas que graba la siguiente tecla que pulsas sin ejecutarla (una que tiene otro comando, y en la app de escritorio la tecla de un menú, se graba, no se ejecuta) y dice si está libre, si ya es del comando o si es de otro comando, al que Sobrescribir y guardar se la quita, dejándolo sin tecla. Con un agente configurado, Sugerir una tecla con IA pide al Agente de IA tres teclas libres que encajen con el comando, cada una con su motivo. Buscar por tecla, junto a la búsqueda, muestra el comando que tiene una tecla que pulsas, o dice que está libre.
Plugins: cada plugin con su interruptor, su descripción y sus ajustes como formulario; un ajuste marcado local se guarda en esta máquina. Plugins →
Preferences: el aspecto, ordenado como la Apariencia de Obsidian: el esquema de color base (Adaptar al sistema, Claro u Oscuro), un color de acento, un tema (el predeterminado, uno incluido con Eidos como Catppuccin, AnuPpuccin, Nord, Gruvbox, Tokyo Night o Ledger, o uno tuyo, hecho en el editor de temas con el lado claro junto al oscuro, importado de un archivo CSS o de una bóveda de Obsidian, y exportado como un solo archivo CSS), las fuentes de la interfaz, del texto y monoespaciada, el tamaño del texto al leer y editar, y Ctrl con la rueda del ratón para cambiarlo; después el idioma (inglés, español o portugués, o el que pida tu sistema), la vista por defecto, el ancho de página (Fixed o Fluid, también Change default page width to en la paleta), las teclas de la paleta, la esquina en la que aparecen las notificaciones (arriba a la derecha por defecto), los editores externos (tantos como quieras, cada uno un nombre y un comando, elegidos entre los habituales como VS Code, Cursor, Zed o Sublime Text, o escritos), si las notas de la versión se muestran tras una actualización, si el tablero del Backlog dibuja cada subtarea como una tarjeta (Show subtasks on the board, apagado por defecto), si la foto de cada persona viene de Gravatar donde se dibujan sus iniciales (Show Gravatar pictures, activo por defecto: la página envía a gravatar.com un hash SHA-256 del correo de cada usuario, nunca el correo, y mantiene las iniciales para quien no tiene foto, correo o red; a un agente nunca se le busca y lleva la marca del agente, un destello en el color de acento; apagado, no se envía nada), y el orden de los grupos y actividades de la barra lateral. Yo guarda quién eres en todos los proyectos (tu nombre, tu correo, tu capacidad técnica y cómo te gusta que te ayuden), copiado en el me.md de cada proyecto; Preguntar a tu IA lo rellena desde el Agente de IA para que lo revises, y Copiar el prompt hace la misma pregunta a cualquier IA. Informes de uso y errores, en Preferences → General, desactiva los informes anónimos de qué se usa y qué falla, y muestra cada informe tal como salió de este equipo. Privacidad →
Novedades: cada versión con su titular y un resumen de una frase, y una página por versión, con sus entradas agrupadas en Nuevo, Mejorado, Cambiado y Corregido, desde la página de versiones. Tras una actualización, la página abre una vez la de la versión nueva, con las versiones que te saltaste; What’s New en la paleta las lista todas, Show Release Notes abre la tuya, y Home termina con ella.

Todo lo que la app recuerda es YAML en .eidos/plugins/eidosmd/: settings.yaml y el views.yaml de las vistas compartidas viajan con el proyecto, local.yaml es tuyo e ignorado por git (igual que una carpeta local/ a su lado). Nada se guarda en el almacenamiento del navegador ni en una base de datos.

El Registro

Registry, bajo Workspace en Settings y en la paleta, es el Registro dentro de la página: cada Framework publicado allí, como una tabla de nombre y descripción, categoría, colecciones e instalaciones en los últimos 30 días, con un filtro de categoría y una búsqueda a la izquierda. Una fila abre el Framework sobre la tabla (Abrir en esta pestaña para su propia página, /registry/@owner/name): sus colecciones con el template (la plantilla) de cada variant (la variante) como el archivo que es, sus roles, documentos de nivel superior, propiedades y README, cada pieza marcada según la tiene este proyecto: en absoluto, igual o de otra forma.

La página de un Framework ordena sus piezas en Nuevo en este proyecto, El tuyo es distinto y Ya está aquí, y Qué cambia lista lo que escribiría incluir las elegidas. Cada pieza que le falta al proyecto empieza marcada; desmarca las que quieras, o elige una sola, como eidos install <package> --variant … toma una. Una propiedad viene con su colección, o con todo lo nuevo (--all). Una pieza que el proyecto tiene de otra forma conserva la tuya salvo que elijas Usar el del framework en lugar de Conservar el tuyo. El botón dice cuántas piezas incluye (Incluir 3 piezas), y lo que llega es exactamente lo que escribe eidos install <package> --collection … --on-conflict … --yes: el índice reescrito, la revisión ejecutada, la procedencia registrada y la única petición de conteo de instalaciones enviada. eidos install →

Cuando no se puede llegar al Registro, no se lista nada y no se puede incluir nada; Try again vuelve a preguntarle. Un README se muestra con su HTML como texto y sus imágenes como enlaces, así que la página sigue sin cargar nada de fuera.

La página lista Frameworks. Los plugins de fuera del paquete y las configuraciones de plugins aparecen en el Registro y se instalan desde la terminal, eidos plugin install @owner/name y eidos install @owner/name. Plugins de fuera →

Canvas

Una actividad propia, que lista cada lienzo con sus páginas. Un lienzo es una pizarra de páginas donde un nodo es un boceto (una idea que todavía no es un Blueprint), un Blueprint (dibujado en vivo desde su archivo), una nota adhesiva o texto libre, con flujos entre ellos, marcos alrededor de regiones e hilos de comentarios fijados a cualquier cosa. Un boceto se promueve a Blueprint por el mismo andamiaje que eidos new y conserva su sitio. Los nodos se estilizan con las propiedades del propio Framework. Una página se exporta como PNG, SVG o JSON Canvas para Obsidian.

Navegar por el lienzo → es el manual: cada herramienta, gesto, atajo y el archivo en disco.

Cómo está construido

Una app Preact incluida en Eidos MD como archivos estáticos, servida por el módulo http del propio Node con una API JSON bajo /api/ (las rutas de un plugin bajo /api/plugins/<name>/), ligada solo a la interfaz de loopback. Sin recursos externos, así que funciona sin conexión. La búsqueda usa texto completo de SQLite (node:sqlite con su módulo FTS5, en el Node que lleva la app, nada que compilar).