O que é um recipe (v4)?
Um arquivo YAML sob <workspace>/.solomd/agents/*.yml. Um arquivo = um job de agente. Campos requeridos: name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. Opcionais: schedule (cron), match (glob), allow-write, write-cap, provider, model, allowlist tools. SoloMD entrega 11 starters em Configurações → Recipes → Explorar cookbook — instale um, edite, execute. O schema completo vive em docs/agents.md.
Escritas de agente são seguras?
Cada execução de recipe começa ramificando do main: agent/<recipe>/<run-id>. Escritas pousam apenas naquela branch. No sucesso a execução vai para Pending — examine o diff e clique Aceitar (fast-forward para main) ou Rejeitar (apagar a branch inteiramente). Uma execução rejeitada deixa zero rastros no seu histórico. Escritas também impõem um cap por execução (padrão 5, teto duro 50) — um modelo que pede para escrever 100 arquivos quando o cap é 5 recebe recusas a partir da 6ª chamada, sem estado meio-aplicado.
Como isso é diferente do ghost-text do Cursor ou Copilot?
Cursor e Copilot são ótimos para autocomplete de código no nível de tecla. Os agentes do SoloMD são diferentes em três formas: (1) a unidade de trabalho é o *vault*, não o cursor — agentes leem através de notas via wikilinks, backlinks, busca full-text e tag; (2) escritas são em lote + revisáveis, não ghost-text que você aceita inline; (3) agentes podem rodar em agendamento quando você não está no teclado (revisão semanal, resumo diário, triagem on-tag). Está mais próximo do modo Agent / Composer do Cursor do que do autocomplete inline — e explicitamente não é um autocomplete de estilo de escrita (acreditamos que ghost-text dilui a voz do escritor).
Recipes precisam de uma chave API?
Apenas se o recipe especifica um provider cloud. Para provider: ollama (ou o alias local), nenhuma chave necessária — qwen2.5:1.5b roda grátis na sua máquina. Para provider: claude / openai / gemini / etc, você precisa da chave daquele provider em Configurações → IA (BYOK). O wizard de primeira execução te guia por qualquer caminho.
Como a busca semântica do SoloMD difere do grep?
Grep combina caracteres; busca semântica combina significado. Procure "deployment" e você também pode trazer parágrafos sobre "rolling out", "shipping", "release". O embedder roda inteiramente no nosso processo Rust — sem download de arquivo de modelo, sem chamada de rede, sem cloud. Desligada por padrão; vire o switch em Configurações para opt-in. Índice vive em <workspace>/.solomd/embeddings.sqlite (auto-gitignored).
O SoloMD é realmente grátis?
Sim. SoloMD é software open-source com licença MIT. Não há nível pago, sem conta, sem anúncios. Se ajuda sua escrita você pode patrocinar o desenvolvedor, mas você nunca tem que.
Onde vivem as chaves API para os 20+ providers IA?
No seu chaveiro OS — Apple Keychain no macOS, Credential Manager no Windows, libsecret no Linux. Nunca em localStorage, nunca em arquivo de config que o SoloMD escreva. Solicitações IA vão direto da sua máquina para o provider que você escolheu; SoloMD não hospeda nenhum modelo nem retransmite tráfego.
Que tamanho tem o instalador?
Cerca de ~14–30 MB dependendo da plataforma. Isso é cerca de 6× menor que o Typora e 7× menor que o Obsidian, porque o SoloMD usa Tauri (webview do sistema + Rust) em vez de empacotar Chromium.
Funciona offline?
Sim, completamente. O editor em si faz zero requisições de rede. Busca semântica é apenas local. AutoGit faz commit em um repo local e nunca faz auto-push. O único tráfego de saída é (1) a verificação opcional de atualização de release do GitHub na inicialização (desligada em Configurações) e (2) as chamadas de reescrita IA que você dispara explicitamente, que vão direto para o provider que você escolheu.
Como o servidor MCP funciona?
Um único binário sidecar de 1,5 MB (solomd-mcp) fala o Model Context Protocol via stdio — sem porta de rede. Aponte o Claude Desktop, Cursor ou qualquer cliente MCP para seu workspace e ele ganha 8 ferramentas de leitura (list_notes, read_note, search, get_backlinks, list_tags, get_outline, etc.) mais 2 ferramentas de escrita atrás de --allow-write. Path-traversal protegido, contenção workspace-canonical.
Como o SoloMD lida com arquivos não UTF-8 como GBK / Big5?
O SoloMD auto-detecta a codificação usando a crate Rust chardetng quando você abre um arquivo. UTF-8, UTF-16 LE/BE (com ou sem BOM), GBK, GB18030, Big5, Shift_JIS e muitos outros são reconhecidos e exibidos corretamente.
Posso sincronizar minhas notas em outros dispositivos?
Ainda não — sync CRDT embutida está no roadmap. Por agora o SoloMD funciona perfeitamente com iCloud Drive, Dropbox, OneDrive, Syncthing ou qualquer ferramenta de sync baseada em pasta. Apenas salve suas notas dentro de uma pasta sincronizada. Ou use AutoGit + push manual para o GitHub.
Por que não há plugins?
O SoloMD intencionalmente omite um sistema de plugins para se manter leve, estável e fácil de auditar. As funcionalidades que escritores sérios pedem — busca semântica, histórico de versões, reescrita IA, colar imagem, KaTeX, Mermaid, modo foco, CSS personalizado — todas vêm no core.
Por que "Windows protegeu seu PC" apareceu na primeira execução?
O SoloMD é um pequeno projeto open-source que ainda não construiu reputação no Microsoft SmartScreen. Clique "Mais informações → Executar mesmo assim" uma vez e ele não vai pedir de novo. Estamos trabalhando em um certificado de assinatura de código.
Como abro arquivos .md com SoloMD por padrão?
Clique direito em qualquer arquivo .md → Abrir com → SoloMD → marque "Sempre usar este app". O instalador empacotado registra o SoloMD como handler para extensões .md, .markdown, .mdown, .mkd e .txt.
Qual a diferença entre SoloMD e Obsidian?
Obsidian é uma ferramenta de gestão de conhecimento com vaults, links wiki, backlinks, visualização de grafo e marketplace de plugins. SoloMD é um editor leve para escrever arquivos Markdown — mas entrega algumas coisas que Obsidian não tem (busca semântica no core, AutoGit, servidor MCP, 20+ providers IA em um painel). Use Obsidian se você quer um segundo cérebro com marketplace de plugins; use SoloMD se você quer as ferramentas de escrita sem o plugin tax.
Quais são os requisitos de sistema? O SoloMD funciona no Windows 7?
O SoloMD requer Windows 10 ou superior, macOS 10.15+, uma distribuição Linux atual, iOS 15+ ou Android 7+. Windows 7/8/8.1 não podem ser suportados e não existe build antiga utilizável: a toolchain Rust exige Windows 10 desde a 1.78, e a Microsoft congelou o WebView2 — o motor de renderização do SoloMD — na versão 109 no Windows 7, sem mais atualizações de segurança.