Dicklesworthstone/agentic_coding_flywheel_setup

Bootstraps a fresh Ubuntu VPS into a complete multi-agent AI development environment in 30 minutes: coding agents, session management, safety tools, and coordination infrastructure

Agentic Coding Flywheel Setup (ACFS)

何であるか – 新しいUbuntuまたはArch VPSを、すぐに使える「エージェント型コーディング」ワークステーションに変えるBashベースのインストーラーです。1つのidempotentな curl | bash コマンドで、完全な開発スタック（シェル、ランタイム、クラウドCLIなど）と3つのAIコーディングエージェント（Claude Code、Codex CLI、Antigravity CLI）を一括で導入します。

なぜ重要か – このリポジトリは「AI支援プログラミング」ワークフローに必要なすべてのツールチェーンをバンドルし、個人、チーム、または教室のラボ向けに再現可能なセットアップを可能にします。マニフェストファイルにインベントリを定義し、それをもとにインストーラーを生成することで、監査可能性と簡単な更新を実現しています。

コアコンポーネント（READMEに記載）

コンポーネント	パス	技術	役割
マニフェスト	`acfs.manifest.yaml`	YAML	単一の真実源 – すべてのツール、インストールコマンド、検証手順をリストアップ
ジェネレーター	`packages/manifest/src/generate.ts`	TypeScript + Bun + Zod	マニフェストを解析し、検証してBashカテゴリライブラリ、ドクターチェック、ハーネスを出力
ウェブウィザード	`apps/web/`	Next.js 16 + Tailwind 4	初心者がVPSをレンタルし、SSHキーを生成してインストーラーを実行するのをガイドするインタラクティブな13ステップガイド
インストーラー	`install.sh`	Bash	本番用ワンライナー；生成されたライブラリを読み込み、段階的なインストールを調整
ライブラリスクリプト	`scripts/lib/`	Bash	セキュリティ、チェックサム検証、ヘルスチェック、アップデートなど再利用可能な関数
生成されたスクリプト	`scripts/generated/`	Bash（ソースのみ）	カテゴリ固有のインストールモジュール、ドクターチェック、マニフェストインデックス、チェックサムレジャー
設定ファイル	`acfs/`	シェル/Tmuxファイル	ユーザーレベルのdotfiles（`.zshrc`, `tmux.conf`、オンボーディングレッスン）を `~/.acfs/` にデプロイ
チェックサム	`checksums.yaml`	YAML	すべての外部インストーラーのSHA-256ハッシュ；セキュリティライブラリで使用

インストーラーの動作フロー（概要）

ユーザーがワンライナー（curl … | bash …）を実行。
install.sh が生成されたカテゴリライブラリを読み込む。
マニフェストの phase に従って順序付けられた各モジュールについて、リストされた install コマンドを必要なユーザー（通常は root）として実行。
モジュールが完了すると、対応する verify コマンドが実行され、失敗した場合は実行を中止。
すべての外部インストーラーはHTTPS経由で取得され、checksums.yaml（scripts/lib/security.sh を通して）のSHA-256ハッシュと照合され、その後のみ実行される。
成功すると、VPSには以下のものが構成される：
- モダンなシェル（zsh, oh-my-zsh, powerlevel10k）
- 言語ランタイム（bun, uv/Python, Rust, Go）
- クラウドCLI（Vault, Wrangler, Supabase, Vercelなど）
- エージェント連携ツール（NTM, MCP Agent Mail, SLBなど）
- コマンドラインから呼び出せる状態の3つのAIコーディングエージェント

READMEで強調された主な機能

ワンライナー、idempotent – 安全に再実行可能；最後に完了したフェーズから再開。
「Vibe」モード – 速度最優先の事前設定（パスワード不要sudo、積極的なエージェントフラグ）。
ウィザードウェブサイト – SSHキー作成、VPSレンタル、インストーラー実行までを初心者向けにガイド。
マニフェスト駆動の生成 – ツールを追加するには acfs.manifest.yaml の編集のみ。TypeScriptジェネレーターがすべてのBashモジュールを自動更新。
チェックサムベースのセキュリティ – すべての外部スクリプトは実行前に保存されたSHA-256ハッシュと検証される。
再現可能なチーム環境 – --ref を使ってタグやコミットにピン止めすることで、複数マシン間で同一のインストールを保証。

一般的な利用シーン

対象	得られるもの
初心者	ステップバイステップのウェブウィザード、AIエージェントがコードを書ける状態のVPS
個人開発者	新しいVMにフルスタックと3つのコーディングエージェントを備える1つのコマンド。手動設定に費やす時間を数時間節約
チーム／教室	リリースにピン止めしたインストールにより、すべてのメンバーの環境が完全に一致。エージェントワークフローにおける「私のマシンでは動く」問題を排除

はじめ方（READMEから）

# クイックインストール（デフォルトでVibeモード）
{ acfs_installer="$(curl -fsSL \"https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh\")" \
  || acfs_installer="$(curl -fsSL \"https://cdn.jsdelivr.net/gh/Dicklesworthstone/agentic_coding_flywheel_setup@main/install.sh\")"; } \
  && printf '%s\n' "$acfs_installer" | bash -s -- --yes --mode vibe

本番環境では main をタグ（v0.9.0）やコミットSHAに置き換え、--ref を渡すことですべてのスクリプトが同じバージョンを使用するようにします。

ライセンスと出典

ライセンス: MIT + OpenAI/Anthropic Rider（バッジに記載）。したがって、プロジェクトは自由な使用・改変を許可しつつ、基盤となるAIモデルのライセンスを認識しています。
プラットフォームサポート: Ubuntu 22.04以降、およびArchベースのディストリビューション。

結論：ACFSは、VPSホスト型AIコーディング環境の作成を自動化する実用的でオープンソースのブートストラップツールです。マニフェスト駆動アーキテクチャ、チェックサム検証、初心者向けウィザードにより、「エージェント型コーディング」分野に真の貢献をしています。