¿Qué es un recipe (v4)?
Un archivo YAML bajo <workspace>/.solomd/agents/*.yml. Un archivo = un job de agente. Campos requeridos: name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. Opcionales: schedule (cron), match (glob), allow-write, write-cap, provider, model, allowlist tools. SoloMD trae 11 starters en Ajustes → Recipes → Explorar cookbook — instala uno, edítalo, ejecútalo. El esquema completo vive en docs/agents.md.
¿Son seguras las escrituras de agente?
Cada ejecución de recipe comienza ramificando desde main: agent/<recipe>/<run-id>. Las escrituras aterrizan solo en esa rama. En éxito la ejecución va a Pending — examinar el diff y hacer clic Aceptar (fast-forward a main) o Rechazar (eliminar la rama enteramente). Una ejecución rechazada deja cero rastros en tu historial. Las escrituras también imponen un cap por ejecución (por defecto 5, techo duro 50) — un modelo que pide escribir 100 archivos cuando el cap es 5 obtiene rechazos en la 6ta llamada, sin estado semi-aplicado.
¿En qué se diferencia esto del ghost-text de Cursor o Copilot?
Cursor y Copilot son geniales para autocompletar código a nivel de tecla. Los agentes SoloMD son diferentes en tres formas: (1) la unidad de trabajo es el *vault*, no el cursor — los agentes leen a través de notas vía wikilinks, backlinks, búsqueda full-text y tag; (2) las escrituras son por lotes + revisables, no ghost-text que aceptas inline; (3) los agentes pueden correr en programación cuando no estás al teclado (revisión semanal, resumen diario, triaje on-tag). Está más cerca del modo Agent / Composer de Cursor que del autocompletar inline — y explícitamente no es un autocompletar de estilo de escritura (creemos que el ghost-text diluye la voz del escritor).
¿Necesitan los recipes una clave API?
Solo si el recipe especifica un provider cloud. Para provider: ollama (o el alias local), no se necesita clave — qwen2.5:1.5b corre gratis en tu máquina. Para provider: claude / openai / gemini / etc, necesitas la clave de ese provider en Ajustes → IA (BYOK). El wizard de primer lanzamiento te guía a través de cualquier camino.
¿En qué se diferencia la búsqueda semántica de SoloMD de grep?
Grep coincide caracteres; la búsqueda semántica coincide significado. Busca "deployment" y también puedes hacer surgir párrafos sobre "rolling out", "shipping", "release". El embedder corre completamente en nuestro proceso Rust — sin descarga de archivo modelo, sin llamada de red, sin cloud. Apagada por defecto; activa el switch en Ajustes para opt-in. El índice vive en <workspace>/.solomd/embeddings.sqlite (auto-gitignored).
¿SoloMD es realmente gratis?
Sí. SoloMD es software de código abierto con licencia MIT. No hay nivel de pago, sin cuenta, sin telemetría por defecto, sin anuncios. Si ayuda a tu escritura puedes patrocinar al desarrollador, pero nunca tienes que hacerlo.
¿Dónde viven las claves API para los 14 providers IA?
En tu llavero OS — Apple Keychain en macOS, Credential Manager en Windows, libsecret en Linux. Nunca en localStorage, nunca en un archivo de config que SoloMD escriba. Las solicitudes IA van directo de tu máquina al provider que elegiste; SoloMD no aloja modelos ni reenvía tráfico.
¿Qué tamaño tiene el instalador?
Aproximadamente 10–15 MB dependiendo de la plataforma. Eso es aproximadamente 6× más pequeño que Typora y 7× más pequeño que Obsidian, porque SoloMD usa Tauri (webview de sistema + Rust) en lugar de empaquetar Chromium.
¿Funciona offline?
Sí, completamente. El editor mismo hace cero solicitudes de red. La búsqueda semántica es solo local. AutoGit hace commit a un repo local y nunca hace auto-push. El único tráfico saliente es (1) la verificación opcional de actualización de release de GitHub al arrancar (apagada en Ajustes) y (2) las llamadas de reescritura IA que disparas explícitamente, que van directo al provider que elegiste.
¿Cómo funciona el servidor MCP?
Un solo binario sidecar de 1,5 MB (solomd-mcp) habla el Model Context Protocol sobre stdio — sin puerto de red. Apunta Claude Desktop, Cursor o cualquier cliente MCP a tu workspace y obtiene 8 herramientas de lectura (list_notes, read_note, search, get_backlinks, list_tags, get_outline, etc.) más 2 herramientas de escritura tras --allow-write. Path-traversal protegido, contención workspace-canonical.
¿Cómo maneja SoloMD archivos no UTF-8 como GBK / Big5?
SoloMD auto-detecta la codificación usando la crate Rust chardetng cuando abres un archivo. UTF-8, UTF-16 LE/BE (con o sin BOM), GBK, GB18030, Big5, Shift_JIS y muchos más se reconocen y muestran correctamente.
¿Puedo sincronizar mis notas a otros dispositivos?
Aún no — la sync CRDT integrada está en la roadmap v3. Por ahora SoloMD funciona perfectamente con iCloud Drive, Dropbox, OneDrive, Syncthing o cualquier herramienta de sync basada en carpeta. Solo guarda tus notas dentro de una carpeta sincronizada. O usa AutoGit + push manual a GitHub.
¿Por qué no hay plugins?
SoloMD omite intencionalmente un sistema de plugins para mantenerse ligero, estable y fácil de auditar. Las funcionalidades que los escritores serios piden — búsqueda semántica, historial de versiones, reescritura IA, pegar imagen, KaTeX, Mermaid, modo enfoque, CSS personalizado — todas vienen en el core.
¿Por qué apareció "Windows ha protegido tu PC" en el primer lanzamiento?
SoloMD es un pequeño proyecto de código abierto que aún no ha construido reputación de Microsoft SmartScreen. Haz clic en "Más información → Ejecutar de todas formas" una vez y no preguntará de nuevo. Estamos trabajando en un certificado de firma de código.
¿Cómo abro archivos .md con SoloMD por defecto?
Clic derecho en cualquier archivo .md → Abrir con → SoloMD → marcar "Usar siempre esta app". El instalador empaquetado registra SoloMD como handler para extensiones .md, .markdown, .mdown, .mkd y .txt.
¿Cuál es la diferencia entre SoloMD y Obsidian?
Obsidian es una herramienta de gestión de conocimientos con vaults, enlaces wiki, backlinks, vista de grafo y un marketplace de plugins. SoloMD es un editor ligero para escribir archivos Markdown — pero trae algunas cosas que Obsidian no tiene (búsqueda semántica en core, AutoGit, servidor MCP, 14 providers IA en un panel). Usa Obsidian si quieres un segundo cerebro con marketplace de plugins; usa SoloMD si quieres las herramientas de escritura sin el plugin tax.