Files.md - Obsidianのオープンソース代替となるローカルファーストなMarkdownファイルアプリ

 (github.com/zakirullin)
2 ポイント 投稿者 GN⁺ 3 시간 전 | 1件のコメント | WhatsAppで共有
  • ノート・文書・プロジェクト・ジャーナル・習慣・チェックリスト・タスクをプレーンな .md ファイルとして保存する、シンプルな個人知識管理アプリ
  • ローカルファーストで、インストール不要、ブラウザさえあれば動作し、オフライン利用可能なPWA構成
  • Cloudフォルダ同期をサポート: iCloud / Dropbox / Google Drive の既存クラウドフォルダで複数デバイス同期ができ、サーバー運用は不要
  • セルフホストサーバーも可能: 単一のGoバイナリで自前サーバーを運用でき、完全な制御とTelegramボット統合が可能
  • Hosted (app.files.md) 方式: マネージドサーバーを提供し、設定なしですぐに使える
  • 高速な記録: チャット欄にメッセージを投げれば、すべてのデバイスに自動同期され、保存先はその場ですぐ選ぶことも、あとで整理することも可能
    • ノート・タスク・日記・チェックリストをすべて同じフローで一度に処理できる。Enter を押すだけで保存完了
  • Telegram Bot は、移動中のファイルアクセスと保存のために利用可能で、他のメッセンジャー対応も予定
    • インボックス項目は**安定したコンテンツハッシュ(fs.Hash)**で識別されるため、他の項目が追加・削除・完了されても、ボタンは正しい行を指し続ける
  • 知識管理の考え方として、高度なテンプレート・プラグイン・AIワークフローよりも自分で考えることを重視し、1つのノートに1つのアイデアを書き、関連ノートをリンクして見直す流れを推奨
  • ファイル構造は Chat.md, brain/Note.md, journal/2024.08 August.md, habits/*.md, media/*, config.json のようにあらかじめ定義されているが、好きな構造を使うこともできる
  • files.md/llms.txt に構造スキーマが用意されており、これを CLAUDE.md や AGENTS.md に貼り付けることで、AIエージェントにファイル構造を理解させられる
  • [ でファイルリンクを挿入、Cmd/Ctrl+P でファイル検索、Cmd/Ctrl+N で新規ファイル作成など、Markdownファイル作業向けのショートカットを提供
  • コードベースは、1人の人間またはLLMが全体を頭の中に収められる程度の単純さを目指しており、PRでは機能追加よりもコード削減と単純化を優先すべきとしている
  • フロントエンドは、ビルドシステムなしで /web/index.html が長い年月の後でもそのまま開けることを志向し、バックエンドはテスト・エラーラッピング・依存性最小化を重視
  • 保存形式と移植性のため、すべてを通常の .md ファイルに保存し、標準Markdownリンクを使って GitHub のような他環境との互換性を維持しようとしている
  • MITライセンス

関連記事

1件のコメント

 
GN⁺ 3 시간 전
Hacker News のコメント

  • Obsidianがオープンソースではないことを改めて認識したが、不思議とオープンソースのように感じさせる面がある
    調べればそうでないのは明らかなのに、やはりオープンソースであるべきような気がしてしまう

    • データは開かれていてMarkdown形式で保存され、プラグインはオープンソース
      中核製品はオープンソースではないが、単なるElectronアプリでもあるので、Obsidianはオープンコア製品の逆のようなものだと見てきた
    • 私の印象はそうではなかったが、プラグイン制作向けのAPIはかなり開かれている
      Obsidianのモデルを擁護するなら、専任のエンジニアリングチームがいて、ツールは無料で、ノートは独自形式ではなく.mdで保存される
      望むなら同期ツールにお金を払うこともでき、価格も妥当で、開発を支援する良いやり方だと思う
      製品も引き続き興味深い方向へ改善されており、審査ポリシーを備えた新しいプラグインマーケットプレイスはかなりよくできていて、目標にできる出来だ
      いずれにせよこのプロジェクトも良さそうだが、私はかなりObsidian伝道者寄りではある
    • 公平に言えば、Obsidianは難読化されていないElectronアプリなので、コードを取り出すのはかなり簡単
      アプリを信用できないならそうしてみては、と公式Obsidianチームがサポートフォーラムで案内していたのを覚えている
    • 数年前にこのプロジェクトを始めた理由がまさにそこだった
      AI時代のソフトウェアはオープンソースとして配布されるべきだと思う
      不格好なプラグインシステムを経由するのではなく、誰でも好きなように直せるべきだ
    • なぜオープンソースでなければならないのかわからない
      Obsidianはユーザーが自分のデータを完全に管理できるようにしており、オープンな標準で保存している
      なぜ開発者が貧困を誓った修道士のように振る舞わなければならないのか説明してほしい
      開発者は価値あるものを作ったのだから、そこから利益を得るべきだ

  • Qt6（QWidgets、C++）でObsidianのネイティブ版を作っている
    Markdownエディタを再現するのにはかなり時間がかかる。ファイルを壊したり、レンダリング済みMarkdownのスタイルを失ったりするやり方があまりにも多いからだ
    それでも進捗はあり、軽量に動作してRAMは約15MB使用、GPUは使わず、カーソルやスクロールが動くときもCPUはほとんど使わない。テキストエディタとは本来こうあるべきだと思う
    基本的な現代的メモ帳として使うには、まだウィジェットテーブル、リスト、コードブロックのシンタックスハイライト描画が必要だ
    オープンソースとして公開するかはわからない。最近は時間の無駄にも見えるが、無料で使えるようにはする予定だ
    https://i.imgur.com/ro9Zq9w.png
    https://i.imgur.com/pbJcTQF.gif

    • AI'm buildingがタイプミスでないなら、AIで作っていることを的確に主張する表現としてかなり気に入った
    • https://asnotes.ioをオープンソースとして公開した
      Markdownベースで、Wikiリンク、タスク管理、カンバンボード、静的サイト公開をサポートしている
      ローカルで動作し、Gitとも相性が良い
      長く生き残る可能性の高い形式と技術で何かを作るのが目的だった
    • 本当に素晴らしい
      Qtを使っているなら、私の理解ではアプリをクローズドソースで配布しようとするとQtのライセンス費用を払う必要があるはずだ
    • フリーソフトウェアになる予定なのか気になる
      Obsidianと完全互換でネイティブアプリのフリーソフトウェアを作るなら、喜んでトークン程度の寄付をしたい

  • これをObsidianの代替としては見せないと思う
    Markdownファイルを共有し、どちらもノート作成用ではあるが、Files.mdにはユーザーが思考・ノート・知識を一緒に扱う独自のやり方があるように見える
    「代替」と読んだときは機能同等性やAPI互換性を想像したが、実際に見たものはまったく異なり、しかもずっと興味深かった
    1年かけて作った成果を使ってみるつもりだ

    • 良い指摘に感謝する
      実際にはObsidian代替として位置付けてはいない。まだより良い紹介文句が思いついていないだけだ
      私にとってはシンプルさ、気軽に何かを追加できる流れ、すぐ使える準備性に近い
      派手さではなく、実際に動くものに集中したいということだ
    • 「完全に所有できるセルフホストのMarkdownノート」や「個人知識サーバー」といった表現が良いかもしれない
      機能面でObsidianと競うより、所有権の側面を強調できる
    • 「代替」という言葉を読んだ瞬間、代替でもないものを代替と呼ぶ人たちへの不満が頭にすぐ浮かんだ

  • Joplinはオープンソースで、デバイス間同期の設定はDropboxに一度ログインするだけで済み、無料で動く
    Windows、macOS、Linux、iOS、Android向けのネイティブアプリもあり、プラグインもかなりある
    同期されるMarkdownファイルだけが必要なら、Obsidian Syncにお金を払うよりこちらを使えばいい
    Dropboxの無料2GB容量は、テキストと少しのスクリーンショットなら十分だ。もちろん自前でホストすることもできる
    Gitはソースコードには素晴らしいが、ノートには煩雑だ

    • ただし、ディスク上で直接編集できるMarkdownファイルではなくSQLiteに保存する
    • Dropboxは使わなくなったが、まだその程度の容量をくれるのはうれしい
      私はGitを使っていてうまく動いており、ノートが消えないという安心感がある
      昔はモバイルでの扱いがより難しかったので専用アプリを使っていたが、今ではObsidian Gitでも十分うまく動く
      さらに改善の余地はあるが、全体としては自分には十分だ
      スマホの日次ノートに音声で内容を入れ、あとでデスクトップで整理するような使い方をしている

  • 一部のセカンドブレイン界隈では、「セカンドブレインは育つがファーストブレインは賢くならない」と言うのが興味深い
    Tiago Forteが自分流のセカンドブレインの目標を「何も記憶しないこと」だと言っていたのを思い出す
    必要な瞬間にセカンドブレインが正しい文脈を出してくれれば、それを読んで吸収するという考え方だが、その言葉でそのブランドへの興味が冷めた
    「Googleで見つけられるなら覚える必要はない」と言っているように聞こえて、あまり好きではない
    私は、セカンドブレインを使ってファーストブレインを強化しようとするこの記事の筆者のビジョンのほうがずっと好きだ

    • すべてを記憶するのが不可能なのはわかっている
      人間は数分前に見たものですら正確に思い出すのがひどく苦手だ
      だからといって何も覚えず、全部をセカンドブレインに投げ込んでしまえば、地図も文脈も、その場で必要なものをどう見つけるかもなくなる
      それは道端の適当な10代に電子工学の教科書を渡して、その場で電源装置を作れと言うようなものだ
      結局のところ明らかにスペクトラムがあり、最適点については誰もが違う考えを持つ。おそらく人によって大きく異なるのだろう
      個人的には、最初から非常に詳細なノートを書くことだけでも情報が頭の中に粘着的に残り、その後ノートを直接参照する必要自体がかなり減る可能性が高まった
      面白い小さなジレンマだ
    • ありがとう
      何年もかけてナレッジベースを育ててきて、結果も良かった
      ノートを始めるのに多くのものは必要ない
      手法もワークフローも不要で、最もシンプルな設定で十分だ
      ただし「Second Brain」は人を興奮させる表現だ
      現実にはあまりうまく機能しないが、売るには非常に都合がいい

  • プレーンテキストファイルのデータを所有するだけでなく、そのファイルを開くソフトウェアも所有すべきだと思う
    そうすればファイルとツールが年月を経ても完全に自分の所有下で一緒に育っていける
    このアプリはLLMで自分の必要に合わせて簡単に改変できるようになっており、コードもそれに合わせて最適化されている
    付け加えると、Goはこの種のソフトウェアにとても合っているように見える

  • チャットインターフェースというアプローチが興味深い
    AIアシスタントが本格化した今なら実現可能に見える

  • Obsidianはオープンソースではないかもしれないが、ファイル形式はJoplinより確実に開かれている
    だからObsidianに移行した
    Syncthingで同期すれば、デスクトップでもスマホでも十分うまく動く

  • ほとんどのMarkdownツールでいまだに物足りないのは、大きなアーキテクチャ文書やMermaidダイアグラムをうまくレンダリングして共有する機能だ
    結局、自分でMarkdownファイルリーダーのhttps://mdview.ioを作ったが、一般的なノートアプリより大きなダイアグラムや表をはるかにうまく扱える

    • MarkdownページをHTMLとしてプレビューし、ライブサーバーでホスティングして動的に更新する簡単なスクリプトを使っている
      Mermaidやシンタックスハイライトなどをレンダリングする
      エージェントと一緒にソフトウェアを計画するときに非常に役立つ
      作業中にページが動的に更新され、ダイアグラムが見えるのも大きな助けになる
      最近は計画段階や必要なタイミングでダイアグラムを含めるよう、プロンプトに入れることがずっと増えた

  • LogSeqを使えばいいだけ: https://discuss.logseq.com/t/whats-new-with-logseq-db-may-16...

    • そのMarkdownミラー機能はかなり良さそうだ
      私はノートにTriliumを使ってきて、アプリ自体は好きだが、ノートの保存と保管の仕組みは気に入らない点の一つだ
      以前、すべてをMarkdownにエクスポートしてみたことがあり、動作はした
      ただ、Triliumはノートを複数の場所に置けるが、バックエンドでは本質的にそのノートを指すポインタとして存在している
      そのためエクスポートが少し奇妙になり、一部のノートインスタンスは実際の内容がない空の殻だけになってしまう
      結局、Markdownファイルが正しい場所に来るようノートを移動して調整しなければならない
      それでもこういう形でノートを複数の場所に置ける点が気に入っていて、結局Triliumを使い続けている