Agentic Coding Flywheel Setup (ACFS)

🌐 agent-flywheel.com — 面向初学者的交互式安装向导

从零开始，在 30 分钟内配置好功能完备的 AI 编程 VPS。 这是一套完整的引导系统，可将全新的 Ubuntu VPS 转化为专业的 AI 驱动开发环境。

愿景

初学者（笔记本电脑） → 安装向导 → VPS → 由 AI 智能体为您编程

---

快速安装

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh?$(date +%s)" | bash -s -- --yes --mode vibe

该安装程序具有幂等性 (idempotent)——如果安装中断，只需重新运行即可。它会自动从最后完成的阶段恢复，无需任何提示。

生产环境： 为了获得稳定、可复现的安装效果，请固定使用带标签的版本或特定的提交 ID：

# 推荐：使用带标签的版本 (例如 v0.5.0)
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/v0.5.0/install.sh" | bash -s -- --yes --mode vibe --ref v0.5.0

# 备选：固定到特定的 commit SHA
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/abc1234/install.sh" | bash -s -- --yes --mode vibe --ref abc1234

带有标签的版本经过了测试且非常稳定。添加 --ref 参数可确保所有获取的脚本版本一致。

---

简述 (TL;DR)

ACFS 是一套用于引导智能体编程环境的完整系统：

为什么要用它：

• 从零到英雄： 带领完全的初学者从“我只有一台笔记本电脑”进阶到“我有 Claude/Codex/Gemini 智能体在 VPS 上为我写代码”。
• 一键魔法： 单条 curl | bash 命令即可安装 30 多种工具，完成所有配置，并设置好三个 AI 编程智能体。
• “Vibe”模式： 预配置以实现极致开发速度——包含无密码 sudo、启用危险智能体标志、优化 shell 环境等。
• 久经考验的栈： 包含完整的 Dicklesworthstone 技术栈（10 种工具+辅助程序），用于智能体编排、协作和安全保障。

你将获得：

• 现代化的 Shell 环境 (zsh + oh-my-zsh + powerlevel10k)
• 所有主流语言运行时 (bun, uv/Python, Rust, Go)
• 三个 AI 编程智能体 (Claude Code, Codex CLI, Gemini CLI)
• 智能体协作工具 (NTM, MCP Agent Mail, SLB)
• 云服务 CLI (Vault, Wrangler, Supabase, Vercel)
• 以及 20 多种其他开发工具

---

ACFS 体验流程

graph LR
    %%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#e8f5e9', 'lineColor': '#90a4ae'}}}%%

    subgraph user ["用户电脑"]
        LAPTOP["笔记本"]
        BROWSER["浏览器"]
    end

    subgraph wizard ["向导网站"]
        STEPS["13步指南"]
    end

    subgraph vps ["全新的 VPS"]
        UBUNTU["Ubuntu 25.10"]
        INSTALLER["install.sh"]
        CONFIGURED["配置好的 VPS"]
    end

    subgraph agents ["AI 智能体"]
        CLAUDE["Claude Code"]
        CODEX["Codex CLI"]
        GEMINI["Gemini CLI"]
    end

    LAPTOP --> BROWSER
    BROWSER --> STEPS
    STEPS -->|SSH| UBUNTU
    UBUNTU --> INSTALLER
    INSTALLER --> CONFIGURED
    CONFIGURED --> CLAUDE
    CONFIGURED --> CODEX
    CONFIGURED --> GEMINI

    classDef user fill:#e3f2fd,stroke:#90caf9,stroke-width:2px
    classDef wizard fill:#fff8e1,stroke:#ffcc80,stroke-width:2px
    classDef vps fill:#f3e5f5,stroke:#ce93d8,stroke-width:2px
    classDef agent fill:#e8f5e9,stroke:#a5d6a7,stroke-width:2px

    class LAPTOP,BROWSER user
    class STEPS wizard
    class UBUNTU,INSTALLER,CONFIGURED vps
    class CLAUDE,CODEX,GEMINI agent

面向初学者

ACFS 在 agent-flywheel.com 提供了一个分步引导网站，指引初学者完成以下操作：

1. 在本地电脑安装终端。
2. 生成 SSH 密钥（用于后续安全访问）。
3. 从 OVH 或 Contabo 等提供商处租用 VPS。
4. 使用密码通过 SSH 连接（初始设置）。
5. 运行安装程序（配置基于密钥的访问）。
6. 使用 SSH 密钥安全重连。
7. 开始使用 AI 智能体编程。

面向开发者

ACFS 提供了一个单行命令，可将任何全新的 Ubuntu VPS 转化为配备现代工具链和三个 AI 编程智能体的功能完备的开发环境。

面向团队

ACFS 提供了一种可复现、幂等的设置，确保团队中每个成员的 VPS 环境完全一致——从而消除了智能体工作流中常见的“在我的机器上能运行”的问题。

---

架构与设计

ACFS 构建于单一事实来源 (Single Source of Truth) 之上：即清单文件（manifest file）。其他一切——包括安装脚本、健康检查程序、网站内容——均源自于该文件。