flutter-ai-container

flutter-ai-container

Docker コンテナ内で Claude Code をヘッドレス起動し、Flutter リポジトリのスナップショットに対して 自由にコーディングさせ、結果を レビュー可能な patch として取り出す仕組みです。 Claude Code プラグインとして利用できます。

仕組み

1. ホスト側で対象リポジトリの HEAD を git archive で repo.tar 化し、prompt.txt と一緒に runs/<run-id>/input/ に配置する。
2. コンテナを起動し、repo.tar を /workspace/work に展開 → 一時 git リポジトリ化 → （任意の setup.sh フック）→ flutter pub get → claude "<prompt>" --dangerously-skip-permissions を実行。
3. 変更分を git diff で runs/<run-id>/output/ai-change.patch にエクスポート。
4. ホスト側で git apply --check / --stat して内容を確認し、必要なら適用する。

入力資材は コードのスナップショットと指示書 (prompt) の2つだけ。コンテナは隔離環境なので、 ホストの作業ツリーを汚さずに試行できます。

インストール（プラグイン）

Claude Code のプラグインとして任意のプロジェクトから /run-ai-task を使えるようにする手順です。

/plugin marketplace add chooyan-eng/flutter-ai-container
/plugin install flutter-ai-container@flutter-ai-container

ローカルで動かしている本リポジトリから直接インストールする場合は、add の引数を絶対パスにします。

/plugin marketplace add /path/to/flutter-ai-container
/plugin install flutter-ai-container@flutter-ai-container

使い方

CLI

./run-ai-task.sh /path/to/flutter_app /path/to/prompt.txt task-name [/path/to/setup.sh]

スラッシュコマンド（プラグイン）

/run-ai-task <app_dir> <prompt_file> <task_name> [setup_file]

プロジェクト固有のブートストラップ（任意）

monorepo やコード生成など flutter pub get だけではビルドできないプロジェクト向けに、 任意の setup.sh を実行ごとに渡せます。コンテナ内で repo.tar 展開後・flutter pub get 前に /workspace/work をカレントとして実行されます。

# 例: melos monorepo
cat > /tmp/setup.sh <<'EOF'
dart pub global activate melos
melos bootstrap
EOF
./run-ai-task.sh ./my_monorepo ./prompt.txt my-task /tmp/setup.sh

• setup.sh を渡した場合でも、ルートに pubspec.yaml があれば後段で flutter pub get が走ります。 ルートが Flutter パッケージでない monorepo では自動でスキップされるため、依存解決は setup.sh 側（melos bs 等）に任せられます。
• 渡さなければ従来どおり素の flutter pub get のみ。

Flutter バージョンの指定

イメージのビルドに使う Flutter SDK バージョンは次の優先順で決まります（上が優先）。

1. 環境変数 FLUTTER_VERSION（明示指定 / run-ai-task.sh の自動検出結果）
2. 利用プロジェクト側の FVM 設定 — run-ai-task.sh が app_dir の .fvmrc （{"flutter": "x.y.z"}）または .fvm/fvm_config.json（flutterSdkVersion）を読んで採用
3. .env の FLUTTER_VERSION（このリポジトリ唯一のデフォルト）

バージョンは Dockerfile・compose に直書きせず .env に一元化されており、イメージタグ （local/flutter-ai-claude:<version>）にも反映されます。プロジェクトが FVM でバージョンを 固定していれば、run-ai-task.sh 実行時に自動でそのバージョンのイメージがビルドされます。

# 明示指定したい場合
FLUTTER_VERSION=3.27.0 ./run-ai-task.sh ./my_app ./prompt.txt my-task

認証の永続化

claude-persist/ にコンテナ内 ~/.claude と ~/.claude.json をマウントし、Claude のログイン状態を 保持します。この配下は認証トークン・履歴を含むため Git 管理対象外（.gitignore 済み）です。 初回はコンテナ内で claude にログインしてください。

ディレクトリ

パス	役割	Git
Dockerfile / docker-compose.yml	Flutter + Android + Claude Code 環境	✅
run-ai-task.sh	エントリーポイント	✅
scripts/	ワークスペース準備 / patch エクスポート	✅
commands/	プラグインのスラッシュコマンド	✅
.claude-plugin/plugin.json	プラグインメタデータ	✅
claude-persist/	認証・履歴（実行時生成）	❌
runs/	実行ごとの入出力	❌

注意

• コンテナ内では --dangerously-skip-permissions で動作します。隔離環境かつ patch レビュー前提の設計です。
• 現状は Flutter 専用（Dockerfile / flutter pub get がハードコード）。他言語対応は今後の課題です。

ライセンス

MIT。用途を問わず自由に改変・利用・再配布できます。