プロジェクトを GitHub に保存する

GitHub は、開発者がコードを変更の履歴とともに保管する場所です。MonstarX のプロジェクトを GitHub のリポジトリ（GitHub 上のプロジェクトのフォルダ）にリンクすると、両方がいつも同じ状態に保たれます。MonstarX が作ったものはコミットとしてリポジトリにプッシュされ、あなたや開発者がそこでコミットしたものは MonstarX に取り込まれます。

開発者が自分のエディタでコードを触りたいとき、会社のコードをすべて GitHub で管理しているとき、GitHub からデプロイしているとき（たとえば Railway がそうです）に便利です。

GitHub アカウントを接続するには？

GitHub の接続は MonstarX のアカウント全体で1回だけです。設定›連携 から、またはどのプロジェクトの GitHub ボタンからでも接続できます。いちばん簡単なのは MonstarX の GitHub App です。トークンを作ったり貼り付けたりする必要がなく、MonstarX が触れるリポジトリを自分で正確に決められます。

1. 個人の GitHub アカウントを接続 をクリックします。

   

2. GitHub の画面が開き、アプリをどこにインストールするか聞かれます。あなたの個人アカウントを選びます（組織ではありません）。

3. MonstarX が使えるリポジトリを選びます。All repositories（すべてのリポジトリ）か、Only select repositories（選択したリポジトリのみ）にして使うものにチェックを入れます。あとから GitHub で変更できます。

4. Install をクリックし、GitHub から確認されたら Authorize をクリックします。

5. MonstarX に戻ります。カードに 接続済み · GitHub App と表示されます。

GitHub App について知っておきたいこと：

• 組織の承認は不要。 インストール先は個人アカウントだけです。間違えて組織を選んだ場合は、個人アカウントにインストールし直すよう MonstarX が案内します。
• 新しいリポジトリは個人アカウントに作られます。 Only select repositories を選んでいても、MonstarX が作ったリポジトリにはいつでもアクセスできます。
• 選んだリポジトリが上限です。 既存のリポジトリをリンクするには、アプリに許可したリポジトリである必要があります。追加するには、GitHub のインストール済みアプリの設定から行います。
• アクセス権は短時間で期限が切れ、自動で更新されます。 暗号化して保存され、ブラウザに送られることはありません。

ほかの接続方法

ほかに2つの方法もあります。

方法	使う場面
アクセスを限定した個人リポジトリ（設定では アクセスを限定して個人リポジトリを接続）	個人アクセストークン（GitHub で特定の用途のために作るパスワード）を使って、MonstarX が触れるリポジトリを1つだけにしたい場合。リソースオーナーを個人アカウント、対象をそのリポジトリだけ、権限を Contents: read and write にした Fine-grained トークンを作ります。この種類のトークンでは新しいリポジトリを作れないので、先に GitHub でリポジトリを作ってください。
代わりに GitHub の認可を使う	所属している組織のリポジトリにプッシュしたい場合。GitHub の通常のサインイン画面にはその組織へのアクセスが含まれることがあるので、許可する前に内容を確認してください。

接続後、カードには接続方法（GitHub App、GitHub でサインイン済み、個人用アクセストークン）と、MonstarX が最新の状態に保っているリポジトリの一覧が表示されます。リポジトリごとに最後の同期日時と、同期が 自動 か 手動 かもわかります。あとで別の方法で接続し直すと、以前の接続は置き換えられます。リンク済みのリポジトリはそのままです。

プロジェクトを GitHub に保存するには？

1. プロジェクトを開き、上部バーの GitHub をクリックします（プロジェクトの 設定›エクスポート の GitHub で管理する にもあります）。

2. アカウントがまだ接続されていなければ、その場で接続します。

   

3. 新しいリポジトリ か 既存のリポジトリ を選びます。

   • 新しいリポジトリ：オーナー（あなた、または所属する組織）を選び、リポジトリ名 を入力します。コードを誰でも見られるようにしたい場合を除き、非公開リポジトリ にはチェックを入れたままにして、リポジトリを作成してプッシュ をクリックします。
   • 既存のリポジトリ：owner/repository を入力するか github.com のアドレスを貼り付け、必要なら ブランチ を指定して（空欄ならデフォルトブランチ）、リンクして同期 をクリックします。あなたのアカウントに、そのリポジトリへのプッシュ権限が必要です。

4. MonstarX がプロジェクト全体を、そのままデプロイできるリポジトリとしてプッシュします。同期が完了すると、GitHub ボタンに緑の点が付きます。

新しいリポジトリは「Initial commit from MonstarX」というコミット1つから始まります。既存のリポジトリでは、プロジェクトはブランチの上にコミットされ、MonstarX が管理していないファイル（LICENSE、CI ワークフロー、ドキュメントなど）には一切触れません。

リポジトリには何が入りますか？

エクスポート で得られるものがすべて入ります。アプリのコード、MonstarX のフレームワークのファイル、実行とデプロイのための設定、データベースのマイグレーション、アプリが必要とするシークレットの名前の一覧（値は含みません）、README です。

GitHub に送られないもの：

• シークレットの値、アプリのデータベースの行、アップロードされたファイルは MonstarX に残ります。
• スプレッドシートから取り込んだ行はプッシュされません。リポジトリは公開されることがあり、そこにはお客様の情報が含まれるためです。
• バイナリファイルと 1 MB を超えるファイルはスキップされ、同期ログに記録されます。

MonstarX はいつ同期しますか？

すべての変更を自動でプッシュ がオンのとき（初期設定はオン）、MonstarX は次のタイミングで同期します。

• アプリのファイルを変更したリクエストのあと。コミットメッセージはあなたのリクエストです。
• QA の自動修正のあと。
• バージョンを復元したあと。
• コードビューでファイルを保存または削除したあと。

GitHub メニューの 今すぐ同期 を使えば、好きなときにプッシュとプルができます。手動で同期したい場合は、自動プッシュをオフにしてください。

GitHub で誰かがコードを編集したらどうなりますか？

いつもどおり GitHub でコミットしてください。次の同期で、MonstarX が変更をプロジェクトに取り込みます。

• アプリ自身のファイル（src/、public/、migrations/、README.md）の変更は MonstarX に取り込まれます。プレビューが更新され、新しいデータベースのマイグレーションが実行され、「バージョン」に GitHub から： とコミットの件名が付いたバージョンが追加されます。
• チャットに「GitHub から3個のファイルを取り込み」のようなカードが表示され、ファイルの一覧がわかります。あなたも MonstarX のエージェントも、何が変わったかを把握できます。
• package.json や設定ファイルなど、MonstarX のフレームワークのファイルへの変更は、MonstarX 自身が次にそのファイルを変更するまで GitHub 側にだけ残ります。
• 同じファイルが両方で変更された場合、MonstarX は自分の内容を残し、あなたの変更は GitHub の履歴に残ります。カードには「両方で変更 — MonstarX 側の内容を維持」と表示されます。

ヒント

開発者が GitHub でファイルを変更している間は、同じファイルを MonstarX に同時に変更させないようにしましょう。こまめに同期（今すぐ同期）すると、両方の差が小さく保たれます。

リンク後の GitHub メニューには何が表示されますか？

• リポジトリ、ブランチ、そして 非公開 か 公開 か。
• 最後に同期した時刻（「5分前に同期」など）、または 前回の同期に失敗しました とその理由。
• 今すぐ同期 と リポジトリを開く。
• すべての変更を自動でプッシュ。
• 最近の同期：直近5回分と、それぞれのコミット。
• リポジトリのリンクを解除：同期を停止します。リポジトリは GitHub に残ります。
• 接続を解除：GitHub アカウントの接続を解除します。再び接続するまで何もプッシュされません。

GitHub からインポートしたアプリはどうなりますか？

プッシュできるリポジトリから アプリをインポート すると、プロジェクトはそのリポジトリにリンクされたままになります。同期先は、インポートしたコミットから始まる monstarx という新しいブランチです。元のブランチは動きません。MonstarX の変更に納得したら、GitHub メニューの プルリクエストを作成 から GitHub に移動してマージできます。

よくある質問

GitHub のトークンは必要ですか？

必要ありません。個人の GitHub アカウントを接続 で MonstarX の GitHub App がインストールされます。GitHub でサインインしてリポジトリを選べば完了です。個人アクセストークンは、その方法で MonstarX を1つのリポジトリだけに限定したい人のための代替手段です。

GitHub App から会社の組織にアクセスできますか？

できません。インストール先は個人アカウントだけで、新しいリポジトリもそこに作られます。組織のリポジトリにプッシュするには、代わりに GitHub の認可を使う で接続するか、組織に追加してもらって自分のアカウントからリンクしてください。

あとから別のリポジトリへのアクセスを MonstarX に与えるには？

GitHub でインストール済みの GitHub Apps の設定を開き、MonstarX を選んでリポジトリを追加します（または All repositories に切り替えます）。そのあと、プロジェクトの GitHub メニューからリンクします。

リポジトリは非公開になりますか？

新しいリポジトリは初期設定で非公開です。コードを公開したい場合だけ 非公開リポジトリ のチェックを外してください。MonstarX がシークレットの値やアプリのデータをプッシュすることはありません。

会社の組織のリポジトリをリンクできますか？

できます。あなたの GitHub アカウントにそのリポジトリへのプッシュ権限があれば使えます。既存のリポジトリ を使うか、新しく作るときに オーナー としてその組織を選んでください。

リポジトリのリンクを解除するとどうなりますか？

MonstarX が同期を停止します。リポジトリとその履歴はすべて GitHub に残り、あとでもう一度リンクできます。

開発者が GitHub で package.json を変更しました。取り込まれないのはなぜですか？

package.json や設定ファイルなどのフレームワークのファイルは MonstarX が管理しています。これらへの編集は、MonstarX が次にそのファイルを変更するまで GitHub 側に残ります。その後の同期で黙って元に戻されることはありません。

リポジトリからデプロイできますか？

できます。リポジトリはそのままデプロイできる状態で、Railway はそこからデプロイします。ほかのホストに公開する もご覧ください。

プロジェクトを譲渡すると、リンクはどうなりますか？

リンクは外れます。新しいオーナーの操作であなたの GitHub アカウントに何かがプッシュされることはありません。リポジトリ自体はそのままです。

関連ページ

コードをエクスポートするプロジェクト全体を zip でダウンロードします。

アプリをインポートするGitHub や zip からアプリを取り込みます。

バージョンすべての変更と、その復元方法。

コーディングエージェントClaude Code、Cursor、Codex でコードをプッシュ・プルします。