origin と origin/main の正体 — clone・remote・branch -r

git clone — GitHub のリポジトリを手元に写す

1. 上が GitHub 側です。memo-app にはコミットが4つあり、ブランチは main と memo の2本です。下の手元には、まだ何もありません。

2. git clone URL は、GitHub のリポジトリを手元に丸ごと写します。コミットは4つとも 手元に来て、上下の同じ横位置に並びました。

   $ git clone https://github.com/you/memo-app.git
   Cloning into 'memo-app'...

3. clone は、いまいる場所にリポジトリと同じ名前のフォルダ memo-app を作ります。

   $ ls
   memo-app

4. ただし、いまいるのはまだ memo-app の外です。Git は not a git repository（ここは Git のリポジトリではない）と言って止まります。

   $ git status
   fatal: not a git repository (or any of the parent directories): .git

5. フォルダの中に入ります。プロンプトに、乗っているブランチ main が出るようになりました。

   $ cd memo-app

6. 作業ツリーにあるのは todo.txt だけで、memo ブランチにある notes.txt はありません。clone が作業ツリーに取り出すのは main の中身だけです。

   $ ls
   todo.txt

7. origin/ が付いていない付箋は main だけです。origin/main・origin/memo・origin/HEAD は、GitHub 側の付箋の写し です。

   $ git log --oneline --all
   a7c3e19 (origin/memo) メモを追加
   e5c0a62 (HEAD -> main, origin/main, origin/HEAD) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

8. 手元のブランチの一覧には main 1本しか出ません。memo のコミットは手元にありますが、それを指しているのは origin/memo の付箋だけです。

   $ git branch
   * main

origin の正体 — remote -v と branch -r・-a・-vv

1. 前の動画で clone したリポジトリの中にいます。git remote は、このリポジトリが知っている リモート（相手のリポジトリ）の呼び名を出します。clone すると、clone 元に origin という呼び名が付きます。

   $ git remote
   origin

2. -v を付けると、呼び名の後ろに住所（URL）が出ます。origin は、この URL に付けた呼び名 です。(fetch) は取ってくるとき、(push) は送るときの住所で、ふつうは同じです。

   $ git remote -v
   origin	https://github.com/you/memo-app.git (fetch)
   origin	https://github.com/you/memo-app.git (push)

3. オプションなしの git branch は、手元のブランチだけを出します。手元にあるのは main 1本です。

   $ git branch
   * main

4. -r は、origin/ の付いた 追跡ブランチ だけを出します。origin/main と origin/memo は、clone したときの GitHub の main と memo の位置です。origin/HEAD -> origin/main は「GitHub の既定のブランチは main」という印です。

   $ git branch -r
     origin/HEAD -> origin/main
     origin/main
     origin/memo

5. -a は、手元のブランチと追跡ブランチを両方出します。追跡ブランチには remotes/ が前に付きます。

   $ git branch -a
   * main
     remotes/origin/HEAD -> origin/main
     remotes/origin/main
     remotes/origin/memo

6. -v は、手元のブランチごとに、指しているコミットの ID とメッセージを添えます。

   $ git branch -v
   * main e5c0a62 パンを追加

7. -vv にすると、角かっこの中に 上流（このブランチの相手）が出ます。clone した main には最初から origin/main が上流に付いているので、git push や git pull だけで相手が決まります。

   $ git branch -vv
   * main e5c0a62 [origin/main] パンを追加

origin/main は自動では動かない

1. Windows のノート PC に clone したリポジトリです。同じリポジトリは Mac にもあり、どちらからも GitHub に push しています。Your branch is up to date with 'origin/main'. は、「main は origin/main と同じ位置にある」という意味です。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   nothing to commit, working tree clean

2. ここで、Mac が「バターを追加」を GitHub に push しました。上の GitHub 側の main だけが1つ進みます。手元のターミナルには何も起きません。

3. もう一度 status を見ても、up to date のままです。GitHub の main は進みましたが、手元の origin/main は動いていません。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   nothing to commit, working tree clean

4. 手元には「バターを追加」がありません。origin/main は 最後に GitHub と話したときの位置 を手元に貼った付箋で、GitHub が進んでも自動では動きません。

   $ git log --oneline --all
   e5c0a62 (HEAD -> main, origin/main, origin/HEAD) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

5. -vv も [origin/main] だけで、遅れ（behind）は出ません。status も -vv も手元の付箋どうしを比べているだけなので、付箋が古ければ答えも古くなります。

   $ git branch -vv
   * main e5c0a62 [origin/main] パンを追加

6. 付箋を新しくするのが git fetch です。GitHub に問い合わせて足りないコミットを取ってきて、origin/main を e5c0a62..c41f0e2 と進めました。main は動きません。

   $ git fetch
   From https://github.com/you/memo-app
      e5c0a62..c41f0e2  main       -> origin/main

7. 今度は behind 'origin/main' by 1 commit（1コミット遅れている）と出ました。付箋が新しくなったので、遅れが分かるようになりました。

   $ git status
   On branch main
   Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
     (use "git pull" to update your local branch)
   
   nothing to commit, working tree clean

8. 「バターを追加」が手元に来て、origin/main がそこを指しています。main を追いつかせる git pull は、2-3 で扱います。

   $ git log --oneline --all
   c41f0e2 (origin/main, origin/HEAD) バターを追加
   e5c0a62 (HEAD -> main) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

origin/memo から手元の memo を作る — git switch

1. clone した直後のリポジトリです。手元のブランチは main だけで、memo は remotes/origin/memo（GitHub 側の写し）としてしかありません。この memo で作業の続きをしたいとします。

   $ git branch -a
   * main
     remotes/origin/HEAD -> origin/main
     remotes/origin/main
     remotes/origin/memo

2. origin/ を付けたまま打つと止まります。a branch is expected, got remote branch は「ブランチを指定してください。指定されたのは追跡ブランチです」という意味です。追跡ブランチは GitHub の写しなので、乗ってコミットすることはできません。

   $ git switch origin/memo
   fatal: a branch is expected, got remote branch 'origin/memo'
   hint: If you want to detach HEAD at the commit, try again with the --detach option.

3. origin/ を外して git switch memo と打ちます。Git は origin/memo と同じ位置に手元の memo を作り、origin/memo を上流に付けてから乗り換えます（set up to track）。

   $ git switch memo
   branch 'memo' set up to track 'origin/memo'.
   Switched to a new branch 'memo'

4. 作業ツリーが memo の中身に入れ替わり、notes.txt が出てきました。

   $ ls
   notes.txt  todo.txt

5. 手元のブランチが2本になり、どちらにも上流が付いています。memo の上流は origin/memo です。

   $ git branch -vv
     main e5c0a62 [origin/main] パンを追加
   * memo a7c3e19 [origin/memo] メモを追加

6. memo と origin/memo が同じコミットに貼られています。ここで memo にコミットすれば、git push だけで GitHub の memo に送れます。

   $ git log --oneline --all
   a7c3e19 (HEAD -> memo, origin/memo) メモを追加
   e5c0a62 (origin/main, origin/HEAD, main) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

7. main に戻ります。作業ツリーも main の中身に戻り、notes.txt は見えなくなります。

   $ git switch main
   Switched to branch 'main'
   Your branch is up to date with 'origin/main'.