1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

GitHub Copilot CLI の設定ファイルを Ubuntu⇔Mac で共有する(Google Drive + symlink)

1
Last updated at Posted at 2026-03-27

はじめに

GitHub Copilot CLI を Ubuntu と Mac の両方で使ってます。

AIへの指示書(copilot-instructions.md)を片方の PC でせっせと育てていくと、もう片方にも反映したくなるんですよね。手動コピーなんて絶対忘れるので、Google Drive + シンボリックリンク で自動同期する構成にしました!

この記事ではその手順と、同期すべきファイル/すべきでないファイルの判断基準をまとめます。

全体図

利点

便利!

  • どの PC で copilot を起動しても 同じ指示書・同じ設定 で動く
  • 片方で指示書を改善したら、もう片方にも勝手に反映される

動作確認環境

項目 Ubuntu 側 Mac 側
OS Ubuntu 24.04 macOS Sequoia 15
Copilot CLI v1.0.12 v1.0.12
Google Drive GNOME Online Accounts(gvfs マウント) Google Drive デスクトップアプリ

~/.copilot/ の中身

まず Copilot CLI が何をどこに保存しているか把握しておきます。

$ ls -lah ~/.copilot/

合計 56K
-rw-------  1 yourname yourname 8.1K  command-history-state.json  ← コマンド履歴
-rw-------  1 yourname yourname 1.8K  config.json                ← CLI設定(モデル選択等)
-rw-rw-r--  1 yourname yourname  19K  copilot-instructions.md    ← ★ AIへの永続指示書
drwxrwxr-x  2 yourname yourname 4.0K  logs/                      ← 実行ログ
-rw-rw-r--  1 yourname yourname  247  mcp-config.json            ← MCP(外部ツール接続)設定
drwxrwxr-x  5 yourname yourname 4.0K  pkg/                       ← CLI本体バイナリ(944MB)
drwx------ 25 yourname yourname 4.0K  session-state/             ← 全セッションの記録

結構いろいろ入ってますね。この中で どれを同期して、どれを同期しないか が大事です。

同期対象の判断基準

ファイル 同期 理由
copilot-instructions.md ✅ する AIへの永続指示書。どのPCでも同じ指示を使いたい!
config.json ✅ する モデル選択・信頼フォルダ等のCLI設定。PC間で統一したい
mcp-config.json ❌ しない MCP サーバーの実行パスがPC固有(/home/yourname/... vs /Users/yourname/...
session-state/ ❌ しない セッションデータは各PCのローカル作業に紐づく
pkg/ ❌ しない CLI本体バイナリ。OS別なので同期不可
command-history-state.json ❌ しない コマンド履歴。PCごとに異なって問題ない

結論: 同期するのは2ファイルだけ!

  • ☁️ 同期: copilot-instructions.md / config.json(AIへの指示書と設定)
  • 💻 同期しない: それ以外(各PCの物理パスに依存するか、ローカル作業データ)

手順

1. Google Drive に同期用フォルダを作成

Google Drive 上に copilot_cli_config_sync(名前は任意)というフォルダを作っておきます。

2. Ubuntu 側: 実体の移動とリンク作成

設定ファイルの実体を Google Drive 同期フォルダへ移動して、元の場所にシンボリックリンクを貼ります。

# Ubuntu での Google Drive パス(GNOME Online Accounts 経由の gvfs マウント)
GDRIVE_SYNC="/run/user/1000/gvfs/google-drive:host=<your-domain>,user=<your-user>/<folder-id>/copilot_cli_config_sync"

# 実体を Google Drive の同期フォルダへ移動
mv ~/.copilot/copilot-instructions.md "$GDRIVE_SYNC/"
mv ~/.copilot/config.json "$GDRIVE_SYNC/"

# 元の場所にシンボリックリンクを作成(-sf で強制上書き)
ln -sf "$GDRIVE_SYNC/copilot-instructions.md" ~/.copilot/copilot-instructions.md
ln -sf "$GDRIVE_SYNC/config.json" ~/.copilot/config.json

# 確認(矢印 -> の先が Drive を向いていれば成功)
ls -l ~/.copilot/copilot-instructions.md ~/.copilot/config.json

Ubuntu の gvfs マウントパスはめちゃくちゃ長いです。ファイルマネージャで Google Drive フォルダを開いてターミナルにドラッグ&ドロップすると楽に取得できます!

3. Mac 側: リンクの作成

Mac 側の初期ファイルを削除して、Google Drive 上の実体へリンクを貼ります。

# Mac 側の初期設定ファイルを削除(念のためバックアップ取ってからやると安心)
cp ~/.copilot/copilot-instructions.md ~/.copilot/copilot-instructions.md.bak
cp ~/.copilot/config.json ~/.copilot/config.json.bak
rm ~/.copilot/copilot-instructions.md
rm ~/.copilot/config.json

# Google Drive 上の実体へリンク
MAC_GDRIVE="$HOME/Library/CloudStorage/GoogleDrive-<your-email>/マイドライブ/<path-to>/copilot_cli_config_sync"

ln -s "$MAC_GDRIVE/copilot-instructions.md" ~/.copilot/copilot-instructions.md
ln -s "$MAC_GDRIVE/config.json" ~/.copilot/config.json

# 疎通確認(Ubuntu で書いた指示書の内容が見えるか)
cat ~/.copilot/copilot-instructions.md

4. 確認

設定後の ls -l でリンク先が Google Drive を向いていれば OK です!

$ ls -l ~/.copilot/copilot-instructions.md ~/.copilot/config.json

lrwxrwxrwx 1 yourname yourname 209 copilot-instructions.md -> '/run/user/1000/gvfs/google-drive:.../copilot_cli_config_sync/copilot-instructions.md'
lrwxrwxrwx 1 yourname yourname 197 config.json -> '/run/user/1000/gvfs/google-drive:.../copilot_cli_config_sync/config.json'

Copilot CLI を起動して、指示書の内容がちゃんと反映されていることを確認しましょう。

copilot-instructions.md に何を書くか

同期する一番の目玉がこのファイルです。ここに書いた内容は 全セッションで自動的にAIに読み込まれます

僕の場合、以下のようなことを書いてます(といっても自分で書いたわけではなく、キリの良いところで「ここまでを instruction にまとめて」と Copilot に頼んでるだけですw):

  • コマンド実行ポリシー: pip install は確認不要、rm -rf は確認必須、など
  • モデルの使い分けルール: sonnet は初稿・探索向き、opus は高品質な最終成果物向き
  • HTMLレポートの設計規約: カラーパレット、SVG の座標計算ルール、スライドモード実装パターン
  • MCP サーバーの使い方メモ: 特許検索 API の使い分け
  • 過去の失敗からの教訓: 「SVG でラベルが rect の下に隠れる問題 → ラベルは最後に描画」のような具体的な注意事項
# Copilot Custom Instructions

## コマンド実行ポリシー
pip, source, mkdir, touch, cp, mv, cat, ls, cd, uv, npm install
などの環境構築やファイル操作コマンドは、確認なしで実行すること。
ただし sudo や rm -rf などの破壊的なコマンドやシステム変更時は必ず確認を取ること。

## モデルの使い分け
- **sonnet(速い・安い)**: 構成のたたき台作成、探索クエリ、コード生成の初稿
- **opus(深い・高品質)**: 複雑な HTML レポートの一括生成、高精度が求められるタスク
...

要は「AIへの永続メモ」ですね。使えば使うほど育っていくので、これを PC 間で共有できるのは本当に便利です!

指示書はセッション開始時にまるごと読み込まれます。巨大すぎるとコンテキストを圧迫するので、本当に毎回必要な知見だけに絞りましょう。プロジェクト固有の知識は .github/copilot/skills/*.md に分離するのがおすすめです。

まとめ

やること コマンド
実体を Drive に移動 mv ~/.copilot/copilot-instructions.md "$GDRIVE_SYNC/"
シンボリックリンク作成 ln -sf "$GDRIVE_SYNC/copilot-instructions.md" ~/.copilot/copilot-instructions.md
Mac 側もリンク作成 ln -s "$MAC_GDRIVE/copilot-instructions.md" ~/.copilot/copilot-instructions.md

同期対象は copilot-instructions.mdconfig.json の2ファイルだけ です。それ以外はPC固有のパスに依存するか、ローカル作業データなので同期しません。

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?