【時短術】ダブルクリックだけで開発環境を一括起動！シンプルなBashスクリプトで作る「プロジェクト起動ツール」

はじめに

皆さん、プロジェクト開始時の「儀式」はありますか？

私の場合はこんな感じでした：

Finderでプロジェクトフォルダを探す
エディタ（Cursor, VSCode など）を起動してプロジェクトを開く
ターミナルを開いてサーバーを起動
ブラウザを開いて localhost にアクセス
リファレンスやドキュメントのブックマークを開く

この「儀式」、毎回数分間かかりますよね。一日に何度もプロジェクトを切り替える場合、この数分が積み重なると馬鹿にならない時間になります。そこで今回は、**「ダブルクリックだけでこれら全てを自動化する」**方法を紹介します！

この記事でわかること

Bashスクリプトで開発環境の起動を自動化する方法
設定を保存して再利用する仕組み
複数プロジェクト対応のためのテクニック
エディタ、ブラウザ、サーバーの連携方法

作成するもの

今回作成するのは run_project.command というファイル。これをダブルクリックするだけで：

✅ プロジェクトをエディタ（Cursor）で開く
✅ 開発サーバーを自動起動
✅ ブラウザで開発中のページを表示
✅ リファレンスページも同時に開く
✅ 必要なコマンドを自動実行

しかも初回設定後は、これらの設定を記憶してくれるので、次回からは本当に「ダブルクリックだけ」でOKです！

環境

macOS（Finderでダブルクリックして実行するため）
Bash（基本的なシェルスクリプト）
Python（簡易HTTPサーバー用）
Cursor（コードエディタ、他のエディタでも応用可能）
Google Chrome（他のブラウザでも応用可能）

スクリプトの作成

まずは run_project.command というファイルを作成し、以下の内容を記述します：

#!/bin/bash

# 設定ファイルのパス
# スクリプト名をベースにした設定ファイル名を生成
SCRIPT_NAME=$(basename "$0" .command)
CONFIG_FILE="$HOME/.${SCRIPT_NAME}_settings.conf"

# 色の設定
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color

# 設定1: プロジェクトルートディレクトリの取得と保存
get_project_root() {
    if [ ! -f "$CONFIG_FILE" ] || [ ! -s "$CONFIG_FILE" ] || ! grep -q "PROJECT_ROOT=" "$CONFIG_FILE"; then
        echo -e "${YELLOW}プロジェクトルートディレクトリの絶対パスを入力してください:${NC}"
        read project_root
        
        # 設定ファイルがなければ作成
        if [ ! -f "$CONFIG_FILE" ]; then
            touch "$CONFIG_FILE"
        fi
        
        # 既存の設定を削除して新しい設定を追加
        sed -i '' '/PROJECT_ROOT=/d' "$CONFIG_FILE" 2>/dev/null
        echo "PROJECT_ROOT=$project_root" >> "$CONFIG_FILE"
        echo -e "${GREEN}プロジェクトルートディレクトリが保存されました${NC}"
    fi
    
    # 設定を読み込む
    source "$CONFIG_FILE"
    return 0
}

# 設定2: 開きたいプロジェクトページの取得と保存
get_project_page() {
    if [ ! -f "$CONFIG_FILE" ] || ! grep -q "PROJECT_PAGE=" "$CONFIG_FILE"; then
        echo -e "${YELLOW}開きたいプロジェクトのページを入力してください（例: index.html）:${NC}"
        read project_page
        
        # 既存の設定を削除して新しい設定を追加
        sed -i '' '/PROJECT_PAGE=/d' "$CONFIG_FILE" 2>/dev/null
        echo "PROJECT_PAGE=$project_page" >> "$CONFIG_FILE"
        echo -e "${GREEN}プロジェクトページが保存されました${NC}"
    fi
    
    # 設定を読み込む
    source "$CONFIG_FILE"
    return 0
}

# 設定3: URLの取得と保存
get_reference_url() {
    if [ ! -f "$CONFIG_FILE" ] || ! grep -q "REFERENCE_URL=" "$CONFIG_FILE"; then
        echo -e "${YELLOW}Chromeで開きたい仕様書やリファレンスなどのURLがありますか？ (Y/N):${NC}"
        read has_url
        
        if [[ $has_url == "Y" || $has_url == "y" ]]; then
            echo -e "${YELLOW}URLを入力してください:${NC}"
            read reference_url
            
            # 既存の設定を削除して新しい設定を追加
            sed -i '' '/REFERENCE_URL=/d' "$CONFIG_FILE" 2>/dev/null
            echo "REFERENCE_URL=$reference_url" >> "$CONFIG_FILE"
            echo -e "${GREEN}リファレンスURLが保存されました${NC}"
        else
            # URLがない場合は空に設定
            sed -i '' '/REFERENCE_URL=/d' "$CONFIG_FILE" 2>/dev/null
            echo "REFERENCE_URL=" >> "$CONFIG_FILE"
            echo -e "${GREEN}プロジェクトを開始します${NC}"
        fi
    fi
    
    # 設定を読み込む
    source "$CONFIG_FILE"
    return 0
}

# 設定4: コマンドファイルの取得と保存
get_command_file() {
    if [ ! -f "$CONFIG_FILE" ] || ! grep -q "COMMAND_FILE=" "$CONFIG_FILE"; then
        echo -e "${YELLOW}叩いて欲しいコマンドファイルがありますか？ (Y/N):${NC}"
        read has_command
        
        if [[ $has_command == "Y" || $has_command == "y" ]]; then
            echo -e "${YELLOW}コマンドファイルのパスを入力してください:${NC}"
            read command_file
            
            # 既存の設定を削除して新しい設定を追加
            sed -i '' '/COMMAND_FILE=/d' "$CONFIG_FILE" 2>/dev/null
            echo "COMMAND_FILE=$command_file" >> "$CONFIG_FILE"
            echo -e "${GREEN}コマンドファイルが保存されました${NC}"
        else
            # コマンドファイルがない場合は空に設定
            sed -i '' '/COMMAND_FILE=/d' "$CONFIG_FILE" 2>/dev/null
            echo "COMMAND_FILE=" >> "$CONFIG_FILE"
            echo -e "${GREEN}プロジェクトを開始します${NC}"
        fi
    fi
    
    # 設定を読み込む
    source "$CONFIG_FILE"
    return 0
}

# サーバープロセスをクリーンアップする関数
cleanup() {
    echo -e "${YELLOW}サーバーを停止しています...${NC}"
    # ポート5502で実行中のプロセスを検索して終了
    SERVER_PID=$(lsof -ti:5502)
    if [ ! -z "$SERVER_PID" ]; then
        kill -9 $SERVER_PID 2>/dev/null
    fi
    echo -e "${GREEN}クリーンアップ完了${NC}"
    exit 0
}

# 終了時にクリーンアップを実行するよう設定
trap cleanup EXIT INT TERM

# 設定の更新
update_setting() {
    case $1 in
        1)
            sed -i '' '/PROJECT_ROOT=/d' "$CONFIG_FILE" 2>/dev/null
            get_project_root
            ;;
        2)
            sed -i '' '/PROJECT_PAGE=/d' "$CONFIG_FILE" 2>/dev/null
            get_project_page
            ;;
        3)
            sed -i '' '/REFERENCE_URL=/d' "$CONFIG_FILE" 2>/dev/null
            get_reference_url
            ;;
        4)
            sed -i '' '/COMMAND_FILE=/d' "$CONFIG_FILE" 2>/dev/null
            get_command_file
            ;;
        *)
            echo -e "${YELLOW}無効な入力です。以下から選択してください:${NC}"
            echo -e "1: プロジェクトルートディレクトリ"
            echo -e "2: 開きたいページ"
            echo -e "3: 開きたいURL"
            echo -e "4: 叩きたいコマンドファイル"
            ;;
    esac
    
    echo -e "${GREEN}設定は保存されました${NC}"
}

# メインの処理
main() {
    # 各設定を取得
    get_project_root
    get_project_page
    get_reference_url
    get_command_file
    
    # 既存のサーバープロセスをクリーンアップ
    SERVER_PID=$(lsof -ti:5502)
    if [ ! -z "$SERVER_PID" ]; then
        echo -e "${YELLOW}既存のサーバーを停止しています...${NC}"
        kill -9 $SERVER_PID 2>/dev/null
        sleep 1
    fi
    
    # プロジェクトを開始
    echo -e "${GREEN}プロジェクトを開始します...${NC}"
    
    # 5. Cursorでプロジェクトを開き、簡易サーバーを起動する
    echo -e "${BLUE}プロジェクトをCursorで開きます...${NC}"
    open -a "Cursor" "$PROJECT_ROOT"
    
    # 簡易HTTPサーバーを起動（バックグラウンドで）
    echo -e "${YELLOW}簡易HTTPサーバーを起動しています...${NC}"
    
    # カレントディレクトリをプロジェクトルートに変更
    cd "$PROJECT_ROOT"
    echo -e "${YELLOW}現在のディレクトリ: $(pwd)${NC}"
    echo -e "${YELLOW}ファイルの存在を確認: ${PROJECT_PAGE}${NC}"
    if [ -f "$PROJECT_PAGE" ]; then
        echo -e "${GREEN}ファイルが見つかりました${NC}"
    else
        echo -e "${YELLOW}注意: ${PROJECT_PAGE} が見つかりません。パスを確認してください。${NC}"
        # ファイル一覧を表示
        echo -e "${YELLOW}現在のディレクトリのファイル一覧:${NC}"
        ls -la
    fi
    
    # Pythonの簡易HTTPサーバーを使用（ポート5502でバックグラウンド実行）
    # Pythonのバージョンをチェック
    PYTHON_VERSION=$(python3 -c 'import sys; print(sys.version_info.major)' 2>/dev/null)
    
    if [ "$PYTHON_VERSION" -eq 3 ]; then
        # Python 3の場合
        (python3 -m http.server 5502 &) 2>/dev/null
    else
        # Python 2の場合（念のため）
        (python -m SimpleHTTPServer 5502 &) 2>/dev/null
    fi
    
    # サーバーが起動するまで少し待機
    sleep 2
    
    # Chromeでプロジェクトページを開く（ルートからの相対パスを使用）
    echo -e "${BLUE}ブラウザでページを開きます: http://127.0.0.1:5502/${PROJECT_PAGE}${NC}"
    open -a "Google Chrome" "http://127.0.0.1:5502/${PROJECT_PAGE}"
    
    # リファレンスURLがあれば開く
    if [ ! -z "$REFERENCE_URL" ]; then
        echo -e "${BLUE}リファレンスURLを開きます...${NC}"
        open -a "Google Chrome" "$REFERENCE_URL"
    fi
    
    # コマンドファイルがあれば実行
    if [ ! -z "$COMMAND_FILE" ] && [ -f "$COMMAND_FILE" ]; then
        echo -e "${BLUE}コマンドファイルを実行します...${NC}"
        bash "$COMMAND_FILE"
    fi
    
    # 6. プロジェクトはすでにCursorで開いている
    
    # 7. 設定変更のインタラクティブモード
    echo -e "${YELLOW}設定を変更するには、以下のキーを入力してください:${NC}"
    echo -e "1: プロジェクトルートディレクトリ"
    echo -e "2: 開きたいページ"
    echo -e "3: 開きたいURL"
    echo -e "4: 叩きたいコマンドファイル"
    echo -e "q: 終了"
    
    while true; do
        read -n 1 setting_key
        echo ""
        
        if [[ $setting_key == "q" ]]; then
            echo -e "${GREEN}終了します${NC}"
            break
        fi
        
        update_setting $setting_key
    done
}

# スクリプト実行
main

ファイルを作成したら、ターミナルで実行権限を付与します：

chmod +x run_project.command

使い方

初回実行時

Finderで run_project.command をダブルクリック
以下の情報を順番に入力：
- プロジェクトルートディレクトリの絶対パス
- 開きたいプロジェクトページ（index.htmlなど）
- リファレンスURLの有無と、あればそのURL
- 実行したいコマンドファイルの有無と、あればそのパス

2回目以降

Finderで run_project.command をダブルクリックするだけ！

仕組みの解説

1. 設定の保存と読み込み

このスクリプトの肝は、設定を保存して再利用する仕組みです。ホームディレクトリに .run_project_settings.conf というファイルを作成し、ここに設定を保存します。

# スクリプト名をベースにした設定ファイル名を生成
SCRIPT_NAME=$(basename "$0" .command)
CONFIG_FILE="$HOME/.${SCRIPT_NAME}_settings.conf"

これにより、スクリプトをコピーして名前を変えるだけで、別のプロジェクト用の設定ファイルが自動的に作成されます。例えば：

run_web.command → .run_web_settings.conf
run_app.command → .run_app_settings.conf

2. 自動HTTPサーバーの起動

Pythonの標準ライブラリに含まれる簡易HTTPサーバーを使用しています。Python 2と3の両方に対応するため、バージョン判定も行っています。

PYTHON_VERSION=$(python3 -c 'import sys; print(sys.version_info.major)' 2>/dev/null)

if [ "$PYTHON_VERSION" -eq 3 ]; then
    # Python 3の場合
    (python3 -m http.server 5502 &) 2>/dev/null
else
    # Python 2の場合（念のため）
    (python -m SimpleHTTPServer 5502 &) 2>/dev/null
fi

3. プロセス管理

スクリプト終了時にサーバープロセスを自動的に終了させるため、trap コマンドを使用しています。これにより、使い終わった後にゾンビプロセスが残ることを防ぎます。

# 終了時にクリーンアップを実行するよう設定
trap cleanup EXIT INT TERM

4. インタラクティブな設定変更

スクリプト実行中に数字キーを押すだけで設定を変更できる機能も実装しています。これにより、設定ファイルを直接編集する手間が省けます。

while true; do
    read -n 1 setting_key
    echo ""
    
    if [[ $setting_key == "q" ]]; then
        echo -e "${GREEN}終了します${NC}"
        break
    fi
    
    update_setting $setting_key
done

カスタマイズのアイデア

このスクリプトは基本形なので、自分の環境に合わせてカスタマイズしてみましょう：

エディタの変更: Cursorの代わりにVSCodeやSublime Textを使いたい場合は、open -a "Cursor" の部分を変更します。
ブラウザの変更: Chromeの代わりにSafariやFirefoxを使いたい場合は、open -a "Google Chrome" の部分を変更します。
ポート番号の変更: デフォルトでは5502ポートを使用していますが、他のポートを使いたい場合は該当する箇所を変更します。
追加のツール起動: Slackやチャットツールなども一緒に起動したい場合は、コマンドを追加します。

まとめ

今回紹介した「プロジェクト起動ツール」は、シンプルなBashスクリプトでありながら、日々の開発作業を大幅に効率化してくれます。特に、複数のプロジェクトを行き来する開発者にとっては、切り替えの手間を大幅に削減できるでしょう。

設定の保存・再利用の仕組みも実装しているので、一度設定すれば次回からはダブルクリックだけでOK。これだけで一日に数分〜数十分の時間節約になります。小さな工夫ですが、長い目で見れば大きな効果をもたらすはずです。

ぜひ、自分の開発環境に合わせてカスタマイズして、より快適な開発ライフを手に入れてください！

GitHub リポジトリ

このスクリプトのソースコードとドキュメントは以下のリポジトリで公開しています：
github.com/hiroki-abe-58/ignition

気に入ったらぜひスターをつけてください！また、改善案やフィードバックもお待ちしています。

何か質問やフィードバックがあれば、コメント欄でお待ちしています！