Configuración
El modal de Configuración organiza las opciones de ComdTeX en pestañas verticales: General, Editor, Vista previa, Notas diarias, PDF, Sync y Asistente IA. Cada opción lleva una descripción de una línea dentro de la app; esta página es la versión larga, con para qué sirve cada una, su valor por defecto, y guías paso a paso donde una opción necesita más de una frase.
Cuatro opciones más viven fuera del modal, en el popover de Enfoque, y están documentadas al final.
Todas las opciones se guardan en el almacenamiento local de la aplicación en esta máquina, no en la nube: si usas ComdTeX en otro ordenador, tendrás que configurarlo de nuevo ahí. La única excepción es la clave de API de IA, que vive aparte en el llavero del sistema operativo (ver El asistente de IA). Los cambios se aplican de inmediato: no hace falta reiniciar ComdTeX después de tocar ninguna de estas opciones.
General
| Opción | Qué hace | Por defecto |
|---|---|---|
| Idioma | Idioma de toda la interfaz (Español / English), sin reiniciar | es |
| Tema | Tema visual del editor: claro, oscuro o alto contraste | vs-dark (oscuro) |
| Gestos de touchpad | Activa zoom con Ctrl+rueda/pinch y cambio de pestaña con swipe de borde | activado |
| Token de NASA ADS | Necesario solo para citar por bibcode de ADS. Se guarda en el llavero del sistema, nunca en los ajustes | vacío |
Editor
| Opción | Qué hace | Por defecto |
|---|---|---|
| Tamaño de fuente | Tamaño de letra del editor, en píxeles (11-24) | 15 px |
| Autoguardado | Intervalo de espera tras dejar de escribir antes de guardar (300 ms / 800 ms / 1,5 s / 3 s) | 800 ms |
| Meta de palabras | Objetivo de palabras del documento activo para la barra de estado; 0 desactiva la meta | 0 (sin meta) |
| Modo Vim | Activa atajos y modos de edición estilo Vim (via monaco-vim) | desactivado |
| Modo máquina de escribir | Mantiene la línea activa centrada verticalmente mientras escribes | desactivado |
| Ajuste de línea (word wrap) | El texto se ajusta al ancho del panel en vez de desbordar horizontalmente | activado |
| Minimapa | Muestra el minimapa de Monaco a la derecha del editor | desactivado |
| Corrector ortográfico | Corrector offline (diccionarios Hunspell, español + inglés), sin red | desactivado |
| Continuar listas | Al pulsar Enter, continúa listas, tareas - [ ], citas > y filas de tabla | activado |
| Auto-colapsar Excalidraw | Colapsa los bloques :::excalidraw la primera vez que abres un archivo | activado |
| Palabras por minuto de lectura | Velocidad de lectura usada para estimar el tiempo de lectura en la barra de estado | 200 |
Vista previa
| Opción | Qué hace | Por defecto |
|---|---|---|
| Tamaño de fuente de vista previa | Tamaño de letra del panel de vista previa, en píxeles (11-24) | 15 px |
| Vista previa visible | Muestra u oculta el panel de vista previa | activado |
| Scroll sincronizado | Sincroniza el desplazamiento del editor y la vista previa | activado |
| Vista previa de matemáticas | Renderiza KaTeX en el panel de vista previa | activado |
| Tema de vista previa | Tema de color de la vista previa: igual que el editor, claro u oscuro | same (igual que el editor) |
Notas diarias
| Opción | Qué hace | Por defecto |
|---|---|---|
| Notas diarias activadas | Habilita el atajo Ctrl+Shift+D para crear/abrir la nota de hoy | activado |
| Carpeta de notas diarias | Carpeta del vault donde se crean las notas diarias | daily |
| Plantilla de notas diarias | Plantilla de contenido inicial (soporta {{date:YYYY-MM-DD}}) | # {{date:YYYY-MM-DD}} + secciones Tasks/Notes |
| Opción | Qué hace | Por defecto |
|---|---|---|
| Motor WASM (TeX) | Compila con el motor LaTeX WASM incorporado antes de recurrir a un motor local (tectonic/xelatex/pdflatex); si el WASM no está disponible, ComdTeX cae al motor local automáticamente | activado |
| Servidor de paquetes TeX | URL del servidor del que el motor WASM descarga .sty/.cls/fuentes que le falten. El servidor público por defecto tiene historial de caídas; aquí puedes apuntar a un espejo | https://texlive2.swiftlatex.com/ |
| Recompilar PDF automáticamente | Reconstruye el PDF en cada guardado, sin pedirlo manualmente | desactivado |
Sync
Esta pestaña abre con tu situación real en vez de una lista de opciones, porque las dos formas que tiene ComdTeX de sacar un vault de una máquina no son equivalentes.
Git guarda historial. Puede decir qué cambió, cuándo y quién, y cuando dos personas editan las mismas líneas se detiene y pregunta en vez de elegir un ganador. Una carpeta sincronizada guarda una copia. Sin historial, sin revisión, y su idea de un conflicto es dejar un segundo archivo con nombre más largo esperando que alguien lo lea.
Así que git es el mecanismo, y la detección de nube es la red de seguridad para quien nunca va a usar git.
| Lo que dice la pestaña | Qué significa | Qué sigue |
|---|---|---|
| Versionado y compartido | Hay historial y una copia de él vive fuera de esta máquina | Nada |
| Versionado, solo aquí | El historial existe únicamente en este disco | Dale un remoto a donde enviar |
| Viajan copias, sin versiones | Una carpeta sincronizada, sin historial | Empieza a guardar historial con git |
| Nada sale de este disco | Ninguna copia en ningún lado | Empieza a guardar historial con git |
| Un repositorio dentro de una carpeta de la nube | El caso peligroso, ver abajo | Saca el vault de la carpeta sincronizada |
El botón Abrir el panel de Git te lleva directo, y Escribir con alguien más explica cómo compartir un vault sin saber nada de git.
Nunca pongas un repositorio git dentro de una carpeta sincronizada
Si tu vault es un repositorio git y está dentro de Dropbox, Google Drive u OneDrive, ComdTeX te avisa. El cliente de la nube y git escriben sobre los mismos archivos internos, cada uno en el orden en que termina, y una máquina que baje un estado a medio subir se encuentra un repositorio que el propio git reporta como roto. No se nota hasta el día en que se nota.
Saca el vault de la carpeta sincronizada y dale un remoto. Un remoto es justo lo que buscabas en la carpeta sincronizada, y además conserva el historial que un repositorio existe para conservar.
Los dos interruptores
| Opción | Qué hace | Por defecto |
|---|---|---|
| Aviso de mover a carpeta sincronizada | Muestra el banner que sugiere mover el vault dentro de una carpeta de la nube | activado |
| Detección de sync en la nube | Detecta las copias en conflicto que dejan estos servicios, muestra la insignia ☁ Sync y marca esos archivos en el árbol | activado |
La detección nunca mueve ni borra nada por su cuenta: señala las copias en conflicto y ofrece abrir ambas, quedarte con la tuya o tomar la de la otra máquina. Los conflictos de Google Drive no se pueden detectar en absoluto, porque sobrescribe en silencio.
Asistente IA
Conectar un proveedor, paso a paso
- Activa Asistente de IA. Nada sale de tu máquina hasta que lo hagas.
- Elige el Proveedor. Los tres primeros son los servicios grandes; OpenAI-compatible cubre todo lo demás, incluido un modelo corriendo en este computador; CLI de agente local ejecuta un comando de terminal que ya tengas.
- Para OpenAI-compatible, llena la URL base. Para un Ollama local es
http://localhost:11434/v1. - Llena el Modelo tal cual lo escribe ese proveedor (
claude-sonnet-4-5,gpt-4o-mini,llama3.1). Si te acercas pero no aciertas, se rechaza como “no existe ese modelo”. - Pega la clave de API, salvo que el servicio sea local y no necesite ninguna.
- Pulsa Probar conexión. Envía la petición real más pequeña posible y nombra qué está mal, si algo lo está:
| Lo que dice | Qué arreglar |
|---|---|
| El proveedor rechazó la clave | La clave falta, venció, o es de otro proveedor |
| El proveedor no tiene ese modelo | El nombre del modelo, tal cual lo escribe ese proveedor |
| No hubo respuesta | La dirección, y si es local, que el servicio esté encendido |
| Esa dirección no se permite | Usa https:// o una dirección local |
Sirve cualquier proveedor accesible por https://, y también uno en esta máquina. Las peticiones van directo de tu computador a él: nunca pasan por Witara, y ComdTeX no trae ninguna clave propia.
La clave se guarda en el llavero del sistema operativo, aparte del resto de tus ajustes.
| Opción | Qué hace | Por defecto |
|---|---|---|
| Asistente IA activado | Interruptor maestro. Mientras esté apagado, ComdTeX no hace ninguna petición de red relacionada con IA | desactivado |
| Proveedor | Proveedor elegido: Anthropic, OpenAI, Google Gemini, OpenAI-compatible (custom) o CLI de agente local | anthropic |
| URL base | Solo para “OpenAI-compatible”: la URL del endpoint (validada a https:// o http://localhost) | vacía |
| Modelo | Identificador del modelo a usar (p. ej. claude-3-5-sonnet-latest, gpt-4o-mini) | vacío |
| Clave de API | Tu clave del proveedor elegido. Se guarda en el llavero del sistema operativo, no en el resto de la configuración | vacía |
| Comando de CLI | Solo para el proveedor “CLI de agente local”: la línea de comando a ejecutar (p. ej. opencode run, claude -p) | vacío |
| Precalentar conexión | Envía una petición mínima al abrir el chat, para que el primer mensaje real responda más rápido | activado |
Consulta El asistente de IA para el detalle de cada proveedor, los dos puntos de entrada (panel y edición en línea) y los huecos {{?}}.
Temporizador de enfoque
Estos cuatro viven en el popover de Enfoque de la barra superior, no en el modal de Ajustes, porque una duración se cambia mientras usas el temporizador, no mientras configuras la app.
| Opción | Qué hace | Por defecto |
|---|---|---|
| Trabajo | Duración de un tramo de trabajo, en minutos | 25 |
| Descanso | Duración de un descanso corto | 5 |
| Descanso largo | Duración del descanso tras una ronda completa de ciclos | 15 |
| Ciclos antes del descanso largo | Cuántos tramos de trabajo forman una ronda | 4 |
El reloj sigue corriendo con el popover cerrado, y queda una lectura compacta en la barra superior. Ver Herramientas de estudio.
Resumen
Todas las opciones viven en la configuración local de ComdTeX en esta máquina, salvo la clave de API de IA (llavero del sistema). No necesitas reiniciar la app después de cambiar ninguna de ellas: los cambios se aplican al instante.
Settings
The Settings modal organizes ComdTeX’s options into vertical tabs: General, Editor, Preview, Daily notes, PDF, Sync, and AI assistant. Every option carries a one-line description inside the app; this page is the longer form, with what each one is for, its default, and step-by-step walkthroughs where a setting needs more than a sentence.
Four more options live outside the modal, in the Focus popover, and are documented at the end.
All options are saved to this machine’s local app storage, not to the cloud: if you use ComdTeX on another computer, you will need to configure it there again. The one exception is the AI API key, which lives separately in the OS keychain (see The AI assistant). Changes apply immediately: you do not need to restart ComdTeX after touching any of these options.
General
| Setting | What it does | Default |
|---|---|---|
| Language | Language of the whole interface (Español / English), no restart needed | es |
| Theme | Editor visual theme: light, dark, or high contrast | vs-dark (dark) |
| Touchpad gestures | Enables Ctrl+wheel/pinch zoom and edge-swipe tab switching | on |
| NASA ADS token | Only needed to cite by ADS bibcode. Stored in the OS keychain, never in your settings | empty |
Editor
| Setting | What it does | Default |
|---|---|---|
| Font size | Editor font size, in pixels (11-24) | 15 px |
| Autosave | Delay after you stop typing before saving (300 ms / 800 ms / 1.5 s / 3 s) | 800 ms |
| Word goal | Word-count target for the active document, shown in the status bar; 0 disables the goal | 0 (no goal) |
| Vim mode | Enables Vim-style keybindings and modes (via monaco-vim) | off |
| Typewriter mode | Keeps the active line vertically centered as you type | off |
| Word wrap | Text wraps to the pane width instead of overflowing horizontally | on |
| Minimap | Shows Monaco’s minimap on the right side of the editor | off |
| Spellcheck | Offline spellcheck (Hunspell dictionaries, Spanish + English), no network | off |
| List continuation | Pressing Enter continues lists, - [ ] tasks, > quotes, and table rows | on |
| Auto-fold Excalidraw | Collapses :::excalidraw blocks the first time you open a file | on |
| Reading words per minute | Reading speed used to estimate reading time in the status bar | 200 |
Preview
| Setting | What it does | Default |
|---|---|---|
| Preview font size | Preview pane font size, in pixels (11-24) | 15 px |
| Preview visible | Shows or hides the preview pane | on |
| Sync scroll | Synchronizes scrolling between the editor and the preview | on |
| Math preview | Renders KaTeX inside the preview pane | on |
| Preview theme | Preview color theme: same as the editor, light, or dark | same (same as editor) |
Daily notes
| Setting | What it does | Default |
|---|---|---|
| Daily notes enabled | Enables Ctrl+Shift+D to create or open today’s note | on |
| Daily notes folder | Vault folder where daily notes are created | daily |
| Daily notes template | Initial content template (supports {{date:YYYY-MM-DD}}) | # {{date:YYYY-MM-DD}} plus Tasks/Notes sections |
| Setting | What it does | Default |
|---|---|---|
| WASM (TeX) engine | Compiles with the bundled WASM LaTeX engine before falling back to a local engine (tectonic/xelatex/pdflatex); if WASM is unavailable, ComdTeX falls back to the local engine automatically | on |
| TeX package server | URL the WASM engine downloads missing .sty/.cls/font files from. The default public server has a history of outages; point this at a mirror if needed | https://texlive2.swiftlatex.com/ |
| Auto-rebuild PDF | Recompiles the PDF on every save, without asking manually | off |
Sync
This tab opens with your actual situation rather than a list of options, because ComdTeX’s two ways of getting a vault off one machine are not equivalent.
Git keeps a history. It can say what changed, when, and by whom, and when two people edit the same lines it stops and asks instead of picking a winner. A synced folder keeps a copy. No history, no review, and its idea of a conflict is a second file with a longer name that it hopes someone reads.
So git is the mechanism, and cloud detection is the safety net for people who will never use git.
| What the tab says | What it means | What to do next |
|---|---|---|
| Versioned and shared | A history exists and a copy of it lives off this machine | Nothing |
| Versioned, only here | The history exists on this disk alone | Give it a remote to push to |
| Copies travel, nothing versioned | A synced folder, no history | Start keeping history with git |
| Nothing leaves this disk | No copies anywhere | Start keeping history with git |
| A repository inside a cloud folder | The dangerous case, see below | Move the vault out of the synced folder |
The Open the Git panel button takes you straight there, and Write with someone else walks through sharing a vault without knowing any git.
Never put a git repository inside a synced folder
If your vault is a git repository and sits inside Dropbox, Google Drive or OneDrive, ComdTeX warns you. Both the cloud client and git write to the same internal files, each in whatever order it finishes, and a machine that pulls a half-uploaded state gets a repository git itself reports as broken. It stays quiet until the day it is not.
Move the vault out of the synced folder and give it a remote instead. A remote is exactly the thing you were trying to get from the synced folder, and it keeps the history a repository exists to keep.
The two toggles
| Setting | What it does | Default |
|---|---|---|
| Move-to-synced-folder hint | Shows the banner suggesting you move a vault inside a cloud folder | on |
| Cloud sync detection | Detects the conflict copies these services leave, shows the ☁ Sync badge, and marks those files in the tree | on |
Detection never moves or deletes anything on its own: it points at the conflict copies and offers to open both, keep yours, or take theirs. Google Drive’s conflicts cannot be detected at all, because it overwrites silently.
AI assistant
Connecting a provider, step by step
- Turn on AI assistant enabled. Nothing leaves your machine until you do.
- Pick the Provider. The first three are the big services; OpenAI-compatible covers everything else, including a model running on this computer; local agent CLI runs a terminal command you already have.
- For OpenAI-compatible, fill the Base URL. For a local Ollama that is
http://localhost:11434/v1. - Fill the Model exactly as that provider spells it (
claude-sonnet-4-5,gpt-4o-mini,llama3.1). A near-miss is rejected as “no such model”. - Paste the API key, unless the service is local and needs none.
- Press Test connection. It sends the smallest possible real request and names what is wrong if anything is:
| What it says | What to fix |
|---|---|
| The provider refused the key | The key is missing, expired, or belongs to a different provider |
| The provider does not have that model | The model name, exactly as that provider spells it |
| No answer at all | The address, and whether the service is running if it is local |
| That address is not allowed | Use https:// or a local address |
Any provider reachable over https:// works, and so does one on this machine. Requests go straight from your computer to it: they never pass through Witara, and ComdTeX ships no keys of its own.
The key is kept in the OS keychain, apart from the rest of your settings.
| Setting | What it does | Default |
|---|---|---|
| AI assistant enabled | Master switch. While off, ComdTeX makes no AI-related network request at all | off |
| Provider | Chosen provider: Anthropic, OpenAI, Google Gemini, OpenAI-compatible (custom), or local agent CLI | anthropic |
| Base URL | Only for “OpenAI-compatible”: the endpoint URL (validated to https:// or http://localhost) | empty |
| Model | Model identifier to use (e.g. claude-3-5-sonnet-latest, gpt-4o-mini) | empty |
| API key | Your key for the chosen provider. Stored in the OS keychain, not with the rest of your settings | empty |
| CLI command | Only for the “local agent CLI” provider: the command line to run (e.g. opencode run, claude -p) | empty |
| Warm up connection | Sends a minimal request when the chat opens, so the first real message answers faster | on |
See The AI assistant for the detail on each provider, the two entry points (panel and inline edit), and {{?}} gaps.
Focus timer
These four live in the Focus popover in the top bar, not in the Settings modal, because you change a duration while you are using the timer, not while you are configuring the app.
| Setting | What it does | Default |
|---|---|---|
| Work | Length of a work stretch, in minutes | 25 |
| Break | Length of a short break | 5 |
| Long break | Length of the break after a full round of cycles | 15 |
| Cycles before a long break | How many work stretches make a round | 4 |
The clock keeps running with the popover closed, and a compact readout stays in the top bar. See Study tools.
Summary
Every option lives in ComdTeX’s local configuration on this machine, except the AI API key (OS keychain). You do not need to restart the app after changing any of them: changes apply instantly.