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 telemetria por padrão, sem anúncios. Se ajuda sua escrita você pode patrocinar o desenvolvedor, mas você nunca tem que.
Onde vivem as chaves API para os 14 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 10–15 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á na roadmap v3. 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, 14 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.
