git clone --depth 1 --branch feat/border-off <a href="https://github.com/hasii841/coding-tools.git" target="_blank" rel="noopener noreferrer">https://github.com/hasii841/coding-tools.git</a> . rm -rf .git git init git add . git commit -m "init" git remote add origin <a href="https://github.com/hasii841/test2.git" target="_blank" rel="noopener noreferrer">https://github.com/hasii841/test2.git</a> git branch -M main git push -u origin main gh repo create test4 --private git branch -M main gh repo delete hasii841/test3 --yes

プロジェクトごとに複製元となるリポジトリや特定ブランチがどれだったっけ...🤔？と探すのを減らすために、Node.jsの対話型CLIライブラリ「inquirer」と、GitHub CLIを組み合わせて、スターターテンプレートのような仕組みを作ってみました。※この記事内のテンプレートは、GitHubのTemplate Repository（テンプレートリポジトリ）を指していません。<h2 id="hf12c718893">どのような？</h2><ul><li>使いたいテンプレート（リポジトリ＆ブランチ）を選択したり対話形式で設定する</li><li>ローカルの任意パスにクローン＆履歴リセット</li><li>新しいGitHubリポジトリを作成＆初回コミット・プッシュ</li></ul><h2 id="h41670a6c17">使い方イメージ</h2><ol><li>候補は <code>templates.json</code> で管理</li><li><code>node index.js</code>で実行</li><li>スクリプト実行でテンプレート一覧が表示されるので選択</li><li>クローン先のローカルパスを指定</li><li>GitHubリポジトリ名を指定して新規作成</li><li>任意で説明とウェブサイトURLの登録</li><li>自動でローカル初期化・GitHubへプッシュ完了</li></ol>

<h2 id="h814f3b2d44">事前に準備しておくもの</h2>GitHub CLIをインストールしてGitHubへログイン・認証しておくとスムーズです。<blockquote>GitHub CLI は、すべての作業を 1 か所で行うことができるように、pull request、issues、GitHub Actions などの GitHub 機能をターミナルに集めたコマンドライン ツールです。<a href="https://docs.github.com/ja/github-cli/github-cli/about-github-cli" target="_blank" rel="noopener noreferrer nofollow">GitHub CLI について - GitHub Docs</a></blockquote><a href="https://cli.github.com/" target="_blank" rel="noopener noreferrer nofollow">https://cli.github.com/</a><h2 id="h17e1f46878">使用するパッケージ</h2><table><tbody><tr><th colspan="1" rowspan="1">パッケージ名</th><th colspan="1" rowspan="1">用途</th></tr><tr><td colspan="1" rowspan="1">inquirer</td><td colspan="1" rowspan="1">対話的なCLIプロンプト作成</td></tr><tr><td colspan="1" rowspan="1">simple-git</td><td colspan="1" rowspan="1">Node.jsからGit操作を行う</td></tr><tr><td colspan="1" rowspan="1">chalk</td><td colspan="1" rowspan="1">ターミナルの色付き文字表示</td></tr></tbody></table>

#!/usr/bin/env node
import inquirer from "inquirer";
import { simpleGit } from "simple-git";
import { execSync } from "child_process";
import fs from "fs";
import path from "path";
import chalk from "chalk";

// theme.jsonのパス（スクリプトと同じ場所）
const themesPath = path.resolve(process.cwd(), "templates.json");

// テンプレート読み込み
let templates;
try {
 const data = fs.readFileSync(themesPath, "utf-8");
 templates = JSON.parse(data);
} catch (e) {
 console.error(chalk.red("❌ theme.json の読み込みに失敗しました"), e.message);
 process.exit(1);
}

const run = async () => {
 const {
 selectedTemplate,
 targetPath,
 githubRepoName,
 description,
 homepage,
 } = await inquirer.prompt([
 {
 type: "list",
 name: "selectedTemplate",
 message: "テンプレートを選択してください:",
 choices: templates.map((t, i) => ({
 name: `${t.name} (${t.branch})`,
 value: i,
 })),
 },
 {
 type: "input",
 name: "targetPath",
 message: "クローン先のパスを入力してください（例：./project-a）:",
 validate: (input) => (input ? true : "パスは必須です"),
 },
 {
 type: "input",
 name: "githubRepoName",
 message: "新しく作成するGitHubリポジトリ名を入力してください:",
 validate: (input) => (input ? true : "リポジトリ名は必須です"),
 },
 {
 type: "input",
 name: "description",
 message: "リポジトリの説明（任意）:",
 },
 {
 type: "input",
 name: "homepage",
 message: "ウェブサイトURL（任意）:",
 },
 ]);

 const { repo, branch } = templates[selectedTemplate];
 const fullPath = path.resolve(process.cwd(), targetPath);

 // クローン
 fs.mkdirSync(fullPath, { recursive: true });
 process.chdir(fullPath);
 console.log(
 chalk.green(`✅ ${repo} の ${branch} を ${targetPath} にクローン中...`)
 );
 execSync(`git clone --depth 1 --branch ${branch} ${repo} .`, {
 stdio: "inherit",
 });

 // .git 削除
 fs.rmSync(path.join(fullPath, ".git"), { recursive: true, force: true });
 console.log(chalk.yellow("🧹 .git フォルダを削除しました（履歴リセット）"));

 // 新たに git init
 const git = simpleGit();
 await git.init(["--initial-branch=main"]);
 await git.add(".");
 await git.commit("initial commit");
 console.log(chalk.green("✅ ローカルリポジトリを初期化しました"));

 // GitHubに新規リポジトリ作成（GitHub CLI使用）
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

 const pushWithRetry = async (retries = 3, delay = 5000, simulate = false) => {
 for (let i = 0; i < retries; i++) {
 try {
 if (simulate) {
 console.log(chalk.cyan(`🔁 (テスト) push 実行 ${i + 1}回目`));
 if (i < retries - 1) throw new Error("Simulated push failure");
 } else {
 execSync(`git push -u origin main`, { stdio: "inherit" });
 }
 console.log(chalk.green("✅ 初回プッシュが完了しました"));
 return;
 } catch (err) {
 console.warn(chalk.yellow(`⚠ push に失敗しました（${i + 1}回目）`));
 if (i < retries - 1) {
 console.log(
 chalk.gray(`⏳ ${delay / 1000}秒待ってリトライします...`)
 );
 await sleep(delay);
 } else {
 throw new Error("❌ push に3回連続で失敗しました");
 }
 }
 }
 };

 try {
 execSync(
 `gh repo create ${githubRepoName} --private --source=. --remote=origin` +
 (description ? ` --description "${description}"` : "") +
 (homepage ? ` --homepage "${homepage}"` : ""),
 { stdio: "inherit" }
 );

 console.log(
 chalk.green(`🚀 GitHubに ${githubRepoName} を作成しました。プッシュ中...`)
 );

 await sleep(2000); // 最初の待ち時間（反映待機）

 await pushWithRetry(); // リトライ
 } catch (e) {
 console.error(
 chalk.red("❌ GitHubリポジトリの作成またはプッシュに失敗しました")
 );
 }
};

run();

//記載のrepoは例で実在しません
[
  {
    "name": "Sample React Template",
    "repo": "https://github.com/sample-org/sample-react-template.git",
    "branch": "main"
  },
  {
    "name": "Sample Vue Template (dev branch)",
    "repo": "https://github.com/sample-org/sample-vue-template.git",
    "branch": "develop"
  },
  {
    "name": "Sample Next.js Template",
    "repo": "https://github.com/sample-org/sample-next-template.git",
    "branch": "main"
  },
  {
    "name": "Sample Node API Template",
    "repo": "https://github.com/sample-org/sample-node-api.git",
    "branch": "master"
  },
  {
    "name": "Sample Static Site Template",
    "repo": "https://github.com/sample-org/sample-static-site.git",
    "branch": "main"
  }
]


<h2 id="h7de647adc6">Push失敗時の自動リトライ処理</h2>GitHub CLIで新しいリポジトリを作成した直後、GitHub側のリポジトリ作成が完了する前に push が走ってしまうためまれに git push が失敗することがあります。

const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

const pushWithRetry = async (retries = 3, delay = 5000) => {
//処理
}

<ul><li><code>sleep()</code> 関数でリトライ間隔を制御</li><li>最大 <code>3回</code> までリトライ 失敗が続いた場合はエラーをスロー</li><li><code>chalk</code> を使ってメッセージを視覚的にわかりやすく表示</li></ul>

<h2 id="hc8d85d9b1f">Organization にリポジトリを作成する場合</h2>GitHub CLI (gh) を使ってリポジトリを作成する場合、通常は「自分のアカウントの所有リポジトリ」として作成されます。しかし、会社やチームなどの Organization に作成したい 場合は、オプションで <code>--org</code> を指定する必要があります。

const org = "my-company-org"; // 自分のOrganization名を指定
execSync(
  `gh repo create ${githubRepoName} --private --source=. --remote=origin --org ${org}`,
  { stdio: "inherit" }
);

<ul><li><code>your-org-name</code> には、自分が権限を持っているOrganization名 を指定します。</li><li>オーナー権限や、リポジトリ作成権限を持っていないとエラーになります。</li><li>Organization に所属していても、デフォルトでは <code>gh repo create</code> は個人アカウント側に作られるため、<code>--org</code> を付けないと意図しない場所に作成されてしまうことがあります。</li></ul>

<h2 id="h41d0b5359c">GitHub APIを使った試み😞</h2>最初はGitHub APIでテンプレートリポジトリを有効にしJSONを取得し、質問形式で選択肢を作ろうとしました。デフォルトブランチに設定されている場合は取得できたのですが、それ以外のブランチから実行することができず断念しました。（他に方法があるかもしれません...）リリースからタグを指定して取得も試みましたがうまくいきませんでした。<h3 id="hae532126fc">最終的にGitHub CLIを使う判断に</h3>GitHub CLI を使うことで、対話的かつローカルで完結した操作が可能になり、リポジトリの作成から初回プッシュまでをスムーズに自動化できました。特に今回のように「テンプレートからプロジェクトを素早く立ち上げたい」ケースでは、<code>gh repo create</code> などのコマンドで 手元の作業と GitHub の操作できる点がスムーズだと感じました。

Node.js×GitHub CLIでGitHubリポジトリとローカル環境を一括セットアップ

今まで使っていたもの<ul><li>バージョン管理：Bitbucket → GitHub</li><li>GUI：Sourcetree</li></ul> <h2 id="h67522245fb">GitHub CLI</h2><a href="https://cli.github.com/" target="_blank" rel="noopener noreferrer">https://cli.github.com/</a> よく使うコマンド 導入して変わったこと

GitHubに乗り換えたタイミングでGUIも一緒に見直し。 今まで使っていたもの→GitHub CLI乗り換え後<ul><li>GUI：Sourcetree→CUIに乗り換え VScode Git Bash</li><li>バージョン管理：Bitbucket → GitHub</li><li>履歴を見たいとき Sourcetree→VScode GitLens</li></ul> <h2 id="h67522245fb">GitHub CLI</h2><a href="https://cli.github.com/" target="_blank" rel="noopener noreferrer">https://cli.github.com/</a> <h3 id="he5bd158522">よく使うコマンド</h3>プルリク<code>gh pr create</code>	プルリク作成<code>gh pr merge</code>	マージ<code>gh pr list</code>	一覧 Issue<code>gh issue create</code><code>gh issue list</code><code>gh issue close 0</code>	0=issue番号 リポジトリの操作<code>gh browse</code>	ブラウザで開く<code>gh repo archive</code>	アーカイブする その他<code>gh status</code>	ステータス<code>gh label create</code>	ラベル作成<code>gh help</code>	ヘルプ表示 ブラウザ、エディタ、GUIの行き来がなくなって操作が楽になりました。