Files.md - app local-first de arquivos Markdown, alternativa open source ao Obsidian

 (github.com/zakirullin)
2 pontos por GN⁺ 3 시간 전 | 1 comentários | Compartilhar no WhatsApp
  • Um app simples de gestão de conhecimento pessoal que salva notas, documentos, projetos, diário, hábitos, checklists e tarefas como arquivos .md puros
  • Estrutura de local-first que não exige instalação, funciona só com o navegador e pode ser usada offline como PWA
  • Suporte a sincronização de pasta na nuvem: sincroniza entre vários dispositivos usando pastas já existentes no iCloud / Dropbox / Google Drive, sem necessidade de operar um servidor
  • Também permite servidor self-hosted: executar seu próprio servidor com um único binário Go, com controle total e possibilidade de integração com bot do Telegram
  • Modo Hosted (app.files.md): oferece servidor gerenciado, pronto para uso imediato sem configuração
  • Registro rápido: ao enviar uma mensagem na janela de chat, ela é sincronizada automaticamente em todos os dispositivos, e o local de armazenamento pode ser escolhido na hora ou organizado depois
    • Notas, tarefas, diário e checklists são tratados de uma vez no mesmo fluxo. Basta pressionar Enter para concluir o salvamento
  • O Telegram Bot pode ser usado para acessar e salvar arquivos em movimento, com suporte a outros mensageiros previsto para o futuro
    • Os itens da caixa de entrada são identificados por um hash de conteúdo estável (fs.Hash), então mesmo que outros itens sejam adicionados, removidos ou concluídos, os botões continuam apontando para a linha correta
  • A abordagem de gestão de conhecimento enfatiza pensar diretamente em vez de templates avançados, plugins ou workflows de IA, recomendando um fluxo de colocar uma ideia por nota, vincular notas relacionadas e revisitar depois
  • A estrutura de arquivos vem pré-definida como Chat.md, brain/Note.md, journal/2024.08 August.md, habits/*.md, media/*, config.json, mas você também pode usar a estrutura que quiser
  • Um esquema estrutural é fornecido em files.md/llms.txt, que pode ser colado em CLAUDE.md ou AGENTS.md para que agentes de IA entendam a estrutura dos arquivos
  • Oferece atalhos para trabalhar com arquivos Markdown, como inserir links de arquivo com [, buscar arquivos com Cmd/Ctrl+P e criar novos arquivos com Cmd/Ctrl+N
  • A base de código busca ser simples o suficiente para que uma pessoa ou um LLM consiga compreender tudo mentalmente, e os PRs devem priorizar remover código e simplificar, em vez de adicionar funcionalidades
  • O frontend segue a direção de permitir que /web/index.html continue abrindo normalmente mesmo depois de muito tempo, sem sistema de build, enquanto o backend prioriza testes, wrapping de erros e mínimo de dependências
  • Para preservar o formato de armazenamento e a portabilidade, tudo é salvo como arquivos .md comuns, usando links Markdown padrão para manter compatibilidade com outros ambientes como o GitHub
  • Licença MIT

Leituras relacionadas

1 comentários

 
GN⁺ 3 시간 전
Comentários no Hacker News

  • Eu tinha esquecido que o Obsidian não é open source, mas curiosamente ele tem algo que faz parecer que é
    Mesmo quando você vai conferir e fica claro que não é, continua dando a sensação de que deveria ser open source

    • Os dados são abertos e ficam salvos em formato Markdown, e os plugins são open source
      O produto principal não é open source, mas também é só um app em Electron, então sempre vi o Obsidian como o oposto de um produto open core
    • Essa não era a minha impressão, mas a API para criar plugins é bem aberta
      Em defesa do modelo do Obsidian, há uma equipe de engenharia dedicada, a ferramenta é gratuita e as notas são salvas em .md, não em um formato proprietário
      Se quiser, você pode pagar pela ferramenta de sincronização, o preço é razoável e me parece uma boa forma de apoiar o desenvolvimento
      O produto continua melhorando em direções interessantes, e o novo marketplace de plugins com política de validação ficou muito bem feito, a ponto de servir como referência
      De qualquer forma, este projeto também parece bom, mas eu sou quase um evangelista do Obsidian
    • Para ser justo, o Obsidian é um app em Electron sem ofuscação, então é bem fácil pegar o código
      Se você não confiar no app, lembro que a própria equipe oficial do Obsidian já orientou isso no fórum de suporte
    • Foi exatamente por isso que comecei este projeto alguns anos atrás
      Acho que o software da era da IA deveria ser distribuído como open source
      Em vez de passar por um sistema de plugins desajeitado, qualquer pessoa deveria poder modificar como quiser
    • Não vejo por que isso precisa ser open source
      O Obsidian dá ao usuário controle total sobre seus próprios dados e salva tudo em padrões abertos
      Eu gostaria que me explicassem por que desenvolvedores têm que agir como monges que fizeram voto de pobreza
      Os desenvolvedores criaram algo valioso, então deveriam lucrar com isso

  • Estou fazendo uma versão nativa do Obsidian com Qt6 (QWidgets, C++)
    Leva bastante tempo para recriar o editor de Markdown, porque há muitas formas de quebrar os arquivos ou perder o estilo do Markdown renderizado
    Mesmo assim, há progresso: ele roda leve, usa cerca de 15 MB de RAM, não usa GPU e quase não usa CPU quando o cursor ou a rolagem se movem. Acho que um editor de texto deveria ser assim
    Para servir como um bloco de notas moderno básico, ainda faltam tabelas com widgets, listas e renderização de destaque de sintaxe em blocos de código
    Não sei se vou liberar como open source. Hoje em dia isso parece perda de tempo, mas pretendo disponibilizar gratuitamente
    https://i.imgur.com/ro9Zq9w.png
    https://i.imgur.com/pbJcTQF.gif

    • Se AI'm building não for erro de digitação, eu gostei bastante da expressão como uma forma precisa de dizer que está sendo feito com IA
    • Eu liberei https://asnotes.io como open source
      É baseado em Markdown e oferece links de wiki, gerenciamento de tarefas, quadro kanban e publicação de site estático
      Roda localmente e funciona bem com Git
      A ideia era construir algo com formatos e tecnologias que tenham boas chances de durar
    • Muito legal
      Se você está usando Qt, pelo que entendo, terá que pagar a licença do Qt se quiser distribuir o app como código fechado
    • Fico curioso se vai virar software livre
      Se você fizer um software livre nativo e totalmente compatível com o Obsidian, eu contribuiria de bom grado com algum valor simbólico

  • Eu provavelmente não apresentaria isso como alternativa ao Obsidian
    Ambos compartilham arquivos Markdown e servem para tomar notas, mas o Files.md parece ter um jeito próprio de lidar com pensamentos, notas e conhecimento
    Quando li “alternativa”, pensei em equivalência de recursos e compatibilidade de API, mas o que vi na prática foi algo totalmente diferente e muito mais interessante
    Vou experimentar esse trabalho de um ano

    • Obrigado pela boa observação
      Na prática, eu não estou posicionando isso como uma alternativa ao Obsidian. Só ainda não sei qual seria uma frase de apresentação melhor
      Para mim, isso tem mais a ver com simplicidade, com um fluxo em que você pode acrescentar algo sem esforço e com estar pronto para uso imediato
      A ideia é focar não no que é chamativo, mas no que realmente funciona
    • Algo como “notas Markdown auto-hospedadas que você possui por completo” ou “servidor pessoal de conhecimento” pode funcionar bem
      Isso destaca mais a questão da posse do que uma disputa de funcionalidades com o Obsidian
    • Assim que li a palavra “alternativa”, na hora me veio à cabeça a reclamação sobre gente que chama de alternativa coisas que não são alternativas

  • O Joplin é open source, a configuração de sincronização entre dispositivos funciona de graça com um único login no Dropbox
    Também há apps nativos para Windows, macOS, Linux, iOS e Android, além de uma boa quantidade de plugins
    Se tudo o que você precisa são arquivos Markdown sincronizados, use isso em vez de pagar pelo Obsidian Sync
    Os 2 GB gratuitos do Dropbox bastam para texto e algumas capturas de tela. Claro, você também pode hospedar por conta própria
    Git é ótimo para código-fonte, mas para notas é incômodo

    • Só que ele não salva em arquivos Markdown editáveis diretamente no disco, e sim em SQLite
    • Eu deixei de usar Dropbox, mas é bom saber que ainda oferecem esse tanto de espaço
      Eu uso Git e funciona bem, além de me dar a tranquilidade de saber que as notas não vão desaparecer
      Antigamente era mais difícil no celular, então eu usava um app dedicado, mas hoje em dia o Obsidian Git também funciona bem o suficiente
      Ainda há espaço para melhorar, mas no geral já me atende
      Eu uso voz para colocar conteúdo na nota diária do celular e depois organizo melhor no desktop

  • Acho interessante que, em algumas versões do conceito de second brain, se diga que “o second brain cresce, mas o first brain não fica mais inteligente”
    Lembro que Tiago Forte definiu o objetivo da sua versão de second brain como “não lembrar de nada”
    A ideia seria que, quando necessário, o second brain mostrasse o contexto exato para você ler e absorver, e foi por causa disso que perdi o interesse na marca
    Soa parecido com aquilo de “se dá para achar no Google, não precisa lembrar”, e eu não gosto disso
    Gosto muito mais da visão deste autor de usar o first brain fortalecido por um second brain

    • Eu sei que é impossível lembrar de tudo
      As pessoas são péssimas em recordar com precisão até mesmo algo que viram há poucos minutos
      Mas, se você não lembrar de nada e despejar tudo no second brain, também ficará sem mapa, sem contexto e sem saber como encontrar o que precisa no momento certo
      É parecido com entregar um livro de eletrônica para qualquer adolescente na rua e pedir que monte uma fonte de alimentação ali na hora
      No fim, claramente existe um espectro, e cada um pensa de forma diferente sobre o ponto ideal; quase certamente varia muito de pessoa para pessoa
      Pessoalmente, só o fato de escrever notas muito detalhadas desde o começo já aumentou bastante a chance de a informação grudar na minha cabeça, a ponto de eu precisar menos consultar as notas depois
      É um pequeno dilema interessante
    • Obrigado
      Eu venho ampliando minha base de conhecimento há anos, e os resultados têm sido bons
      Não é preciso muita coisa para começar a fazer anotações
      Não precisa de técnica nem de workflow; a configuração mais simples já basta
      Só que “Second Brain” é uma expressão que empolga as pessoas
      Na prática, não funciona tão bem, mas para vender é excelente

  • Eu acho que não basta possuir os dados em arquivos de texto puro; você também precisa possuir o software que abre esses arquivos
    Assim, os arquivos e a ferramenta podem crescer juntos ao longo do tempo, completamente sob seu controle
    Este app foi feito para ser facilmente modificado com LLMs conforme a necessidade de cada um, e o código também foi otimizado para isso
    Aliás, Go parece combinar muito bem com esse tipo de software

  • Essa abordagem de interface de chat é interessante
    Agora que os assistentes de IA ficaram mais sérios, parece algo viável

  • O Obsidian pode não ser open source, mas o formato de arquivo dele é claramente mais aberto que o do Joplin
    Foi por isso que migrei para o Obsidian
    Com Syncthing para sincronizar, funciona bem o suficiente tanto no desktop quanto no smartphone

  • O que ainda me faz falta na maioria das ferramentas de Markdown é renderizar e compartilhar bem documentos grandes de arquitetura e diagramas Mermaid
    No fim, acabei fazendo meu próprio leitor de arquivos Markdown, https://mdview.io, que lida muito melhor com diagramas e tabelas grandes do que apps de notas comuns

    • Eu uso um script simples que pré-visualiza páginas Markdown como HTML e hospeda isso em um servidor live para atualização dinâmica
      Ele renderiza Mermaid, syntax highlighting e assim por diante
      Isso é muito útil ao planejar software junto com agentes
      Também ajuda muito ver a página sendo atualizada dinamicamente e os diagramas aparecendo durante o trabalho
      Hoje em dia, coloco bem mais prompts para incluir diagramas na fase de planejamento ou quando necessário

  • É só usar o LogSeq: https://discuss.logseq.com/t/whats-new-with-logseq-db-may-16...

    • Esse recurso de espelhamento em Markdown é bem interessante
      Eu tenho usado o Trilium para notas e gosto do app em si, mas uma das coisas de que menos gosto é a forma como ele salva e armazena as notas
      Em certo momento, exportei tudo para Markdown, e funcionou
      Mas o Trilium permite colocar notas em vários lugares e, no backend, isso existe essencialmente como ponteiros apontando para aquela nota
      Então a exportação ficou meio estranha, e algumas instâncias das notas viraram só cascas vazias, sem o conteúdo real
      No fim, tive que ir movendo as notas para fazer os arquivos Markdown irem para os lugares corretos
      Mesmo assim, eu gosto dessa possibilidade de ter as notas em vários lugares, então continuo usando o Trilium mesmo assim