ハクソク

世界を動かす技術を、日本語で。

GitHub Issuesは世界でほぼ最高のノートブックです

364日前原文(simonwillison.net)

概要

GitHub Issuesは、無料かつ無制限で使える強力なノートツール。 Markdownや画像貼り付け、相互リンクなど多彩な機能を搭載。 検索やAPI、GitHub Actionsで自動化も可能。 唯一の弱点はオフライン同期の未対応。 大規模運用やバックアップも柔軟に対応可能。

GitHub Issuesは最強クラスのノートツール

  • 無料・無制限 で利用できるノート管理機能
  • パブリック・プライベート両対応 で個人・チーム利用にも最適
  • Markdown完全対応、多言語のシンタックスハイライトもサポート
  • 画像や動画のドラッグ＆ドロップ による簡単な添付
  • 他Issueやリポジトリとの相互リンク 機能
    • URLを貼るだけでタイトル自動取得・相互参照も自動化
  • 強力な検索機能
    • リポジトリ内、全自分のリポジトリ、全GitHub横断検索に対応
  • 包括的なAPI提供
    • ノートのエクスポート、新規作成や編集も自動化可能
  • GitHub Actionsによる自動化
    • Issueイベントをトリガーに各種処理を自動実行
  • チェックリスト（- [ ] item）記法 対応
    • #refで他Issue参照、関連Issueがクローズ時に自動チェック
  • 大規模運用にも耐えるスケーラビリティ
    • microsoft/vscodeで19万件超、flutter/flutterで10万件超のIssue管理実績

オフライン同期に関する課題

  • 唯一の弱点はオフライン同期未対応
    • ネット接続なしで編集・同期できない点がApple Notes等に劣る
  • 現状はApple Notesと併用、モバイル利用時の利便性確保

セキュリティ・プライバシーと信頼性

  • プライバシー面の懸念は低い
    • 多数の企業がGitHubに機密資産を預けており、信頼性重視
  • パスワード等の機密情報はノートに記載しない運用
    • バグ等による漏洩リスク対策
  • 無料・非セルフホスト型の重要性
    • 課金ミスや設定ミスによるデータ消失リスク回避

バックアップと拡張性

  • github-to-sqlite等によるローカルバックアップ
    • cron等で定期実行すれば安心運用も可能
  • 紙ノートの自動多重バックアップが実現するまではデジタル優先

LLMとの連携・データ活用

  • ノート内容をLLMへパイプしやすいデータ形式

    • 例：llm-fragments-githubで長大なIssueスレッドを要約

  • GraphQLで自分のIssue/コメント数を集計可能

    • GitHub GraphQL Explorerを使い、合計48,500件の実績
    {
  viewer {
    issueComments { totalCount }
    issues { totalCount }
  }
}

  • 豊富なデータ量と柔軟な集計・分析

    • 個人のナレッジベースとしての活用に最適

まとめ

  • GitHub Issuesは多機能・高信頼性・無料のノート管理基盤
  • 唯一の課題はオフライン同期対応
  • 自動化・拡張性・大規模運用にも強み
  • LLMや各種ツールとの連携で新たな活用も拡大

Hackerたちの意見

最後のApple Notesについてだけど、iCloudにはiOSとmacOSで「ダウンロードを保持」するオプションが追加されたよ。これで、iCloudファイルに保存するアプリがNotesみたいに動作するようになった。つまり、オフラインでも使えて、自動でオンライン同期するってわけ。

└

競合をどう処理するの？それと、どのくらいの頻度で同期するの？

└

iCloudって、フォルダ間で物をドラッグするときにまだダウンロードして再アップロードしてるの？

多くの人と同じように、最高のノートアプリを探し続けて何年も経ったけど、結局いつもGitリポジトリの中にあるマークダウンファイルに戻ってきちゃうんだよね。

└

...Obsidianを通じてアクセスしてる（特にモバイルで） -- Androidでは「フォルダをボールトとして開く」ことができるし、ノートパソコンではneovimとFzfLuaを使ってる。

└

私も同じ感じなんだけど、Markdownの代わりにプレーンなorg-modeファイルを使ってて、必要なときにorg-roamタグをちょっと加える感じ。

└

アイデアがあるよ。もうすぐ発表するね！！

└

Gitの中にorg-roam

└

すべてのデバイス間で自動的に双方向同期ができるものと比べると、新しい/編集したノートを手動でコミット/プッシュ/プルしなきゃいけないのは、なんか古臭く感じるよね。

└

この無料でオープンソースのノートアプリを試してみる価値があるかも（注：私のクライアントです）。https://github.com/cybersemics/em/ 「emは個人的な意味づけのための美しくてミニマルなノートアプリです。」

└

Gitリポジトリでマークダウンファイルを使い続けることを強くおすすめするよ。そして、Obsidianを使ってそれらを編集・管理するのもいいと思う。

└

そして、どういうわけか、いつもGitリポジトリの中にある一 bunch のマークダウンファイルに戻ってしまう。他の人も言ってたけど、このワークフローを維持したいなら、私が見つけた中で一番いいアプリはObsidian + Gitプラグインだよ。デスクトップでは素晴らしく動くけど、iOSで動かすにはちょっと手間がかかるね。

└

Apple NotesといくつかのMarkdownファイルの間を行ったり来たりしてるんだけど、これが結構辛いんだよね。Markdownファイルのフォルダは未来に対して安心感があるのが好き。でも、Apple Notesのデザインやシンプルさ、キャプチャやメディアサポートの深い機能も気に入ってる。Markdownアプリが余計な機能をサポートすればするほど、独自性が強くなって、読むためのアプリもそれをサポートしなきゃいけなくなるから、ちょっと面倒くさい。前にApple Notesに専念するって決めたんだけど、他のものに行ったり来たりするのは辛いし、積極的にやるともっと痛い思いをすることになるから、アプリが10年後に消えても痛みが少しだけで済むかもしれないしね。だけど、またMarkdownファイルのフォルダをObsidianに手動で移行中なんだ。エクスポートはしたけど、フォーマットがひどくて、すべてのノートを整理しなきゃいけない。

代わりにCodebergを使えば、ベンダーロックインを避けられるし、Forgejoをセルフホスティングすることもできるよ。

└

自己ホスティングしないで、コストがゼロっていうのはGitHub Issuesの素晴らしい特徴の一つだよ。設定ミスや請求のトラブルで自分のメモを危険にさらしたくないからね。

何年か前に結婚式の計画をするために、GitHubのイシューをプロジェクト管理の手段として使ったんだ。最初は妻も半信半疑だったけど、ラベルを追加したり検索したりできるおかげで、一緒に作業するのがすごく楽になって、結婚式に間に合うようにタスクをこなせたよ。一番大変だったのは、イシュートラッカーに直接リンクするブックマークを作ることだったな。最近の引っ越しでも、GitHubのイシューを使って箱を整理したんだ。イシューを作って、その説明に箱の中身を全部書いて、箱にはイシュー番号を書いておいた。引っ越し後に、GitHubを検索して探しているものを見つけられたし、どの箱に入っているかも分かったんだ。

└

ちょっと興味があって、他にどんな解決策を探ったの？それらが足りなかった理由は何だったの？

└

思い出させるなぁ: https://xkcd.com/1172/ これは面白いエピソードだけど、どこにでも適切なツールを使った方がいいような absurd なワークフローを持ってる人がいるよ。参考までに、私は国を移るときにOrg modeを使って整理したんだ。自分の個人情報をMicrosoftに渡すなんて考えたくもないよ。

└

前の職場では、ほぼすべてのプロジェクト管理にGitlabを使ってた。唯一の障害は、プロジェクト間でリファレンスが使えなかったこと。プロジェクトに特化してるから、オープンソースプロジェクトには十分だけど、今の職場ではGitlabがYoutrackを簡単に引き継げそうだし、すでにUpsourceも引き継いだ。

└

箱に入ってるものをそのまま箱に書けばいいじゃん？

最初のコメントはプライバシーについてだと思ってた。あまりノートは取らないけど、メールよりもさらにプライベートだと思ってる。LLMのトレーニングに使われるのはちょっと嫌だな。MSからプライベートリポジトリのプライバシーについての保証って実際にあるの？

└

MSからプライベートリポジトリのプライバシーについての保証って実際にあるの？ 関連の議論: https://news.ycombinator.com/item?id=36184948

└

GitHubのイシューに含まれる極めて敏感な企業秘密の量を考えると、彼らのセキュリティとプライバシーはかなり堅固だと思う。多くの企業が自社のソースコードや関連するアーティファクトを守るために、GitHubにかなりのお金を払っているんだ。それがGitHubのビジネスモデルだから、プライベートデータでモデルを訓練するためにその信頼を危険にさらすとは思えない。

すごく良い検索機能がある。 現在のログはちょっとデザインを見直す必要があるのに、コメントが見つからない（引用符が必要）。 それに、小さなタイプミス「current logs could」が「redesing」になってるのも失敗の原因だね。

└

確認。GitHubの検索は「検索」だよ、「優れた検索」じゃない。

これ面白いよ！このGraphQLクエリを貼り付けると、GitHubでの投稿したイシューやコメントの合計数が見れるんだ。クエリはこう：{ viewer { issueComments { totalCount } issues { totalCount } } } 俺は9,413のイシューと39,087のコメントがあって、合計で48,500だよ！

こういうベストノートやノート取りシステムを見てると、なんでみんなウィキサーバーを立ち上げないのか不思議に思うんだよね。オンラインにすればどこからでもアクセスできるし、USBメモリからも動かせる（Tiddlywikiとか）。ページを相互リンクさせて、情報をまとめられるし、検索もできる。一部は自動リンクビルダーがあって、カテゴリーに合ったページのリンク集を作れる。マークアップをサポートしてるものもあって、自分好みにフォーマットできる。

└

俺はできるだけシンプルに生きたいから、必要がない限りサーバーは立てたくないんだ。Markdown+gitで十分だし、シンプルだから、何年もウィキは運営してない。匿名編集はあんまり必要ないしね。

偶然、最近これをTODOリストとして使い始めたんだけど、めっちゃ便利だよ。特にGitHubのCLI（gh）を使うときは最高！

ZenHubを使ってみると、もう本当にすごくて、なんで誰がJiraを使うのか理解できないくらいだよ。