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)

是什么 – 一个基于 Bash 的安装程序，可将全新的 Ubuntu 或 Arch VPS 转变为即开即用的「智能体编程」工作站。通过一个幂等的 curl | bash 命令，一次性安装完整的开发栈（shell、运行时、云 CLI 等）和三个 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	交互式 13 步指南，帮助初学者租用 VPS、生成 SSH 密钥并运行安装程序
安装程序	`install.sh`	Bash	生产环境的一行命令；加载生成的库并协调分阶段安装
库脚本	`scripts/lib/`	Bash	可复用的函数，用于安全、校验和验证、健康检查、更新等
生成的脚本	`scripts/generated/`	Bash（仅源码）	类别特定的安装模块、医生检查脚本、清单索引、校验和账本
配置	`acfs/`	Shell/Tmux 文件	用户级 dotfiles（`.zshrc`, `tmux.conf`, 上手教程）部署到 `~/.acfs/`
校验和	`checksums.yaml`	YAML	每个上游安装脚本的 SHA-256 哈希值；由安全库使用

安装程序工作流程（高层次流程）

用户运行 一行命令（curl … | bash …）。
install.sh 加载生成的类别库。
按照清单中的 phase 顺序，对每个模块运行列出的 install 命令 以所需用户身份（通常是 root）执行。
模块完成后，执行相应的 verify 命令；失败则中止运行。
所有外部安装程序均通过 HTTPS 下载，其 SHA-256 哈希值与 checksums.yaml（通过 scripts/lib/security.sh）进行比对，仅在验证通过后才执行。
成功后，VPS 将具备：
- 现代化 shell（zsh, oh-my-zsh, powerlevel10k）
- 语言运行时（bun, uv/Python, Rust, Go）
- 云 CLI（Vault, Wrangler, Supabase, Vercel 等）
- 智能体协调工具（NTM, MCP Agent Mail, SLB 等）
- 可从命令行调用的三个 AI 编程智能体

README 中强调的关键特性

一行命令，幂等性 – 可安全重复运行；从上次完成的阶段继续。
「氛围」模式 – 预配置以追求速度（免密码 sudo，激进的智能体标志）。
向导网站 – 引导绝对初学者完成 SSH 密钥创建、VPS 租赁和安装程序执行。
清单驱动生成 – 添加工具只需编辑 acfs.manifest.yaml；TypeScript 生成器会自动更新所有 Bash 模块。
基于校验和的安全性 – 每个上游脚本在执行前均与存储的 SHA-256 哈希值进行验证。
可复现的团队环境 – 通过 --ref 锁定到标签或提交，确保跨机器的安装完全一致。

典型使用场景

受众	他们获得什么
初学者	分步网页向导，一个“开箱即用”的 VPS，AI 智能体已准备就绪，可为他们编写代码。
个人开发者	一条命令即可为新虚拟机配备完整堆栈和三个编程智能体，节省数小时的手动配置时间。
团队 / 教室	锁定到发布版本的安装确保每位成员的环境完全一致，消除“在我的机器上能运行”的问题，适用于智能体工作流。

快速入门（来自 README）

# 快速安装（默认使用氛围模式）
{ 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 编程环境。其清单驱动架构、校验和验证和对初学者友好的向导，使其成为「智能体编程」领域的真正贡献。