インストール

必要な環境

グローバルインストール（推奨）

# リポジトリから直接インストールgit clone https://github.com/mizchi/git-notes-gh-sync.gitcd git-notes-gh-syncdeno install -Afg --name gng main.ts# インストール後はどこからでも使用可能gnghelp

ローカル実行（インストールなし）

# リポジトリをクローンgit clone https://github.com/mizchi/git-notes-gh-sync.gitcd git-notes-gh-sync# 直接実行deno run -A main.tshelp

使い方

基本的なコマンド

# ヘルプを表示gnghelp# すべての PR と Issue を同期gng sync# 特定の PR を同期gng sync-pr --pr 123# 特定の Issue を特定のコミットに同期gng sync-issue --issue 456 --commit abc1234# 最近のコミットから関連する Issue を同期gng sync-recent --since HEAD~20# ドライラン（実際には書き込まない）gng sync --dry-run

CLI オプション

git notes の確認方法

基本的な確認コマンド

# すべての notes をリスト（形式: <note-object> <commit>）git notes --ref=github/issues listgit notes --ref=github/pulls list# 特定のコミットの notes を確認git notes --ref=github/issues show HEADgit notes --ref=github/pulls show HEAD# JSON を整形して表示git notes --ref=github/issues show HEAD| jq'.'

実用的な例

# コミットログと一緒に確認git log --oneline -5# 出力例: bfbc3a5 Test issue references# そのコミットの Issue 情報を確認git notes --ref=github/issues show bfbc3a5

サンプル表示スクリプト

# 基本的な表示deno run -A examples/example-usage.ts# 詳細表示（最新5コミットの詳細情報）deno run -A examples/example-usage.ts --detail

概要

メリット

使用される git notes の namespace

保存される情報

動作の仕組み

開発者向け情報

ディレクトリ構成

git-notes-gh-sync/├── main.ts              # CLI エントリーポイント（parseArgs 使用）├── lib/│   ├── git.ts          # Git 操作のラッパー│   ├── github.ts       # GitHub API クライアント（gh CLI 使用）│   └── sync.ts         # 同期ロジック├── examples/│   └── example-usage.ts # notes 表示のサンプル（dax 使用）├── deno.json           # Deno 設定ファイル└── README.md           # このファイル

開発用コマンド

# タスクランナー経由での実行deno task sync [command] [options]# 開発モード（ファイル変更を監視）deno task dev# コードフォーマットdeno task fmt# リントdeno task lint# テストdeno tasktest

アーキテクチャ

今後の予定

License