agentic_coding_flywheel_setup Agent工作流

Agentic Coding Flywheel Setup (ACFS)

<p align="center"> <strong>🌐 <a href="https://agent-flywheel.com">agent-flywheel.com</a></strong> — Interactive setup wizard for beginners </p>

From zero to fully-configured agentic coding VPS in 30 minutes. A complete bootstrapping system that transforms a fresh Ubuntu VPS into a professional AI-powered development environment.

Quick Install

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

The installer is idempotent—if interrupted, simply re-run it. It will automatically resume from the last completed phase without prompts.

Production environments: For stable, reproducible installs, pin to a tagged release or specific commit:

> # Preferred: use a tagged release (e.g., 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
>
> # Alternative: pin to a specific commit SHA
> curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/abc1234/install.sh" | bash -s -- --yes --mode vibe --ref abc1234
> 

Tagged releases are tested and stable. Passing --ref ensures all fetched scripts use the same version.

---

The Installer

The installer is the heart of ACFS—a modular Bash script that transforms a fresh Ubuntu VPS into a fully-configured development environment.

Installer Modes

Installation Phases

Why Separate from the Installer?

The installer transforms a fresh VPS. The update command maintains an existing installation. Separating them allows: - Focused updates: Update just agents without touching system packages - Dry-run previews: See what would change before committing - Skip flags: Temporarily exclude categories that are working fine - Stack control: Stack updates are included by default; skip with --no-stack - Automated updates: Run via cron with --yes --quiet

---

`acfs services-setup` — Credential Configuration

Interactive wizard for configuring AI agent credentials and cloud service logins.

acfs services-setup          # Run full setup wizard

Guides you through: - Claude Code: API key configuration - Codex CLI: ChatGPT account login - Antigravity CLI: Google account authentication - GitHub CLI: gh auth login - Cloud CLIs: Wrangler, Supabase, Vercel authentication

Also offers to install DCG (Destructive Command Guard), a Claude Code hook that blocks destructive commands like rm -rf /.

Tools Installed

ACFS installs a comprehensive suite of 30+ tools organized into categories:

Usage

Full vibe mode (recommended for throwaway VPS):

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

Interactive mode (asks for confirmation):

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh" | bash

Safe mode (no passwordless sudo, agent confirmations enabled):

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh" | bash -s -- --mode safe

Usage

acfs-update                  # Update apt, runtimes, shell, agents, cloud CLIs, and stack tools
acfs-update --agents-only    # Only update coding agents
acfs-update --runtime-only   # Only update runtimes (bun, rust, uv, go)
acfs-update --dry-run        # Preview changes without making them
acfs-update --yes --quiet --no-self-update
                             # Automated mode that avoids changing the ACFS tree itself
acfs-update --bootstrap-self-update
                             # Explicitly convert a non-git ACFS install into a git checkout

Options

Category Selection:

--apt-only       Only update system packages
--agents-only    Only update coding agents
--cloud-only     Only update cloud CLIs
--shell-only     Only update shell tools (OMZ, P10K, plugins, Atuin, Zoxide)
--runtime-only   Only update runtimes (bun, rust, uv, go)
--stack          Include Dicklesworthstone stack (enabled by default)

Skip Categories:

--no-apt         Skip apt updates
--no-agents      Skip agent updates
--no-cloud       Skip cloud CLI updates
--no-shell       Skip shell tool updates
--no-runtime     Skip runtime updates (bun, rust, uv, go)

Behavior:

--force            Install missing tools (not just update existing)
--dry-run          Preview changes without making them
--yes, -y          Non-interactive mode (skip prompts)
--quiet, -q        Minimal output (only errors and summary)
--verbose, -v      Show detailed command output
--abort-on-failure Stop on first failure (default: continue)

Antigravity CLI, model/settings/DCG locked by the ACFS launcher

alias agy='$HOME/.local/bin/agy-locked' alias gmi='$HOME/.local/bin/agy-locked' ```

Installation & Updates: Claude Code should be installed and updated using its native mechanisms: - Install: ACFS uses the official native installer (claude.ai/install.sh), checksum-verified via checksums.yaml (installs to ~/.local/bin/claude) - Update: Use claude update --channel latest (built-in) or run acfs update --agents-only

This ensures proper authentication handling and avoids issues with alternative package manager builds. ACFS updates Codex with Bun global package updates and Antigravity with its native agy update path.

Options

acfs doctor              # Interactive colorful output
acfs doctor --json       # Machine-readable JSON output
acfs doctor --quiet      # Exit code only (0=healthy, 1=issues)
acfs doctor --deep       # Run functional tests (auth, connections)
acfs doctor --fix        # Apply safe fixes for failed checks
acfs doctor --dry-run    # Preview fixes without applying
acfs doctor --no-cache   # Skip cache, run all checks fresh

ACFS CLI Commands

After installation, the acfs command provides a unified interface for managing your environment. Each subcommand is designed to be fast, informative, and scriptable.

Quick Reference

acfs info                    # Lightning-fast system overview
acfs cheatsheet              # Discover installed aliases
acfs dashboard generate      # Generate HTML status page
acfs doctor                  # Health checks
acfs newproj                 # Create a new project (TUI or CLI)
acfs update                  # Update all tools
acfs services-setup          # Configure agent credentials
acfs continue                # View upgrade progress after reboot

Command Reference

The Command Reference documents every installed tool:

Components

---

The Generator Pipeline

The TypeScript generator (packages/manifest/src/generate.ts) reads the manifest and produces:

1. Category Scripts (scripts/generated/install_base.sh, install_agents.sh, etc.) - One script per category with individual install functions - Consistent logging and error handling - Verification checks after each module

2. Doctor Checks (scripts/generated/doctor_checks.sh) - All verify commands extracted into a runnable health check - Tab-delimited format (to safely handle || in shell commands) - Reports pass/fail/skip for each module

3. Master Installer (scripts/generated/install_all.sh) - Sources all category scripts - Runs them in dependency order - Single entry point for running the generated installers

Note: The production one-liner installer (install.sh) defaults to the legacy implementations; generated installers are sourced and can be enabled per-category via feature flags during migration.

To regenerate after manifest changes:

cd packages/manifest
bun run generate        # Generate scripts
bun run generate:dry    # Preview without writing

Interactive Website Components

The wizard website includes specialized components for guiding beginners:

ConnectionCheck Component: A prominent visual that helps users verify they're connected to their VPS before running commands: - Side-by-side comparison: "Wrong (laptop)" vs "Right (VPS)" - Terminal prompt examples for Windows, Mac, and Linux - Clear "STOP!" warning with color-coded styling

CommandCard Component: CLI instruction cards with: - Syntax-highlighted code blocks - One-click copy button - Platform-specific variations (bash/zsh/PowerShell) - Expandable explanations

Jargon Component (Responsive Technical Terms): A sophisticated tooltip system that adapts to device capabilities:

Desktop behavior: - Hover reveals floating tooltip with term definition - Radix UI Tooltip for accessible ARIA-compliant overlays - Viewport-aware positioning (auto-flips when near edges) - 200ms hover delay prevents tooltip spam

Mobile behavior: - Tap opens bottom sheet drawer (Vaul library) - Full definition visible without tiny tap targets - Swipe-to-dismiss gesture support - Snap points for partial/full expansion

Visual features: - Gradient underline indicates tappable term - Each term gets unique gradient based on slug hash - Consistent color scheme with OKLCH tokens

Content structure per term:

{
  term: "VPS",
  short: "Virtual Private Server - a remote computer you rent",
  long: "A VPS is your own slice of a powerful computer...",
  analogy: "Think of it like renting an apartment in a building",
  whyWeUseIt: "You get root access, dedicated resources...",
  relatedTerms: ["SSH", "Ubuntu", "RAM"]
}

Confetti Celebration: On lesson completion: - Burst of celebratory confetti particles - Randomized encouraging messages - Special celebration for completing all lessons - Respects prefers-reduced-motion setting

Stepper Component: Multi-step progress indicator: - Visual step-by-step progress - Clickable navigation - Completion checkmarks - Mobile-responsive design

Languages & Package Managers