Agentic Coding Flywheel Setup (ACFS)
One command to transform a fresh Ubuntu VPS into a full multi-agent AI development environment in about 30 minutes.
Evidence shows: installer offers safe mode and vibe mode; safe mode disables passwordless sudo and requires confirmation, but default recommended vibe mode enables passwordless sudo and dangerous flags, and installation via curl|bash skips user confirmation in non-interactive mode. Data flow transparency: README describes installation flow and state file, but lacks details on data collection or transmission. Sensitive data handling: involves SSH key migration, but key storage and permission details are not specified. Dependency security: implements checksums.yaml and SHA256 verification, but auto-update mechanism may introduce risk. External effects: installs many tools and modifies system configuration, but no rollback mechanism provided. Rollback: only re-install and state recovery, no true rollback. Source attribution: author and repository clearly identified, but publisher unverified. Deductions: default recommendation of vibe mode weakens least privilege and user confirmation; data flow and sensitive data handling details insufficient; rollback capability limited.
Evidence shows: README and code structure consistent; installer designed idempotent and resumable, but no actual test results provided. Dependency availability: depends on external installers and network, but provides preflight and cache mechanisms; actual availability not verified. Failure messages: preflight error table and logs provided, but detailed installation failure diagnostics not provided. Deductions: external dependencies, static review cannot verify availability; failure messages exist but not comprehensive.
Evidence shows: targets beginners, developers, and teams; provides wizard website and multiple installation modes, but capability boundaries unclear (e.g., which tools are optional). Trigger precision: installer controlled via command-line arguments, but not all options documented. Environment fit: supports Ubuntu 22.04+, but other systems not mentioned. Deductions: capability boundaries and trigger options documentation incomplete.
Evidence shows: README structure clear, includes installation instructions, architecture diagrams, usage examples, but lacks FAQ and known limitations. Naming stability: version number exists, but naming rules not specified. License: MIT+OpenAI/Anthropic Rider, but metadata NOASSERTION. Versioning: version number and changelog exist, but detailed change records not provided. Maintenance responsibility: author and repository identified, but maintenance commitment not explicit. Deductions: missing FAQ, known limitations, and detailed changelog.
Evidence shows: output is usable development environment, provides 30+ tools and three AI agents, high marginal value, cost-benefit reasonable (free open source). Deductions: static review cannot verify actual effectiveness.
Evidence shows: README claims partially supported by code (e.g., checksums.yaml), but no independent verification. Cross-source: relies solely on repository internal evidence. Fact/inference separation: README distinguishes descriptions and inferences, but not clearly. Deductions: lack of external verification and clear fact/inference separation.
- Default recommended vibe mode enables passwordless sudo and dangerous agent flags, posing security risks.
- Installer executes via curl|bash, skipping user confirmation in non-interactive mode.
- Auto-updating checksums.yaml may introduce unreviewed upstream changes.
- Lack of rollback mechanism makes recovery difficult after failed installation.
- License includes OpenAI/Anthropic Rider, potentially restricting certain use cases.
What does this agent do, and when should you use it?
ACFS is a Bash bootstrapping system that converts a fresh Ubuntu VPS (22.04+, auto-upgrades to 25.10) into a complete development environment with three AI coding agents (Claude Code, Codex CLI, Antigravity CLI). It installs 30+ tools via a single curl|bash command, including shell environment (zsh, oh-my-zsh, powerlevel10k), language runtimes (bun, uv, Rust, Go), cloud CLIs (Vault, Wrangler, Supabase, Vercel), and the Dicklesworthstone stack (ntm, ubs, etc.). The installer is idempotent, resumable, and includes preflight and checksum-based verification. The project also includes an interactive wizard website (agent-flywheel.com), a terminal TUI onboarding, a learning hub, and the ACFS CLI for environment management.
ACFS executes installation scripts in phases on the target VPS: user normalization, APT packages, shell setup, CLI tools, language runtimes, AI agents, cloud tools, Dicklesworthstone stack, configuration deployment, and verification. It generates and deploys configuration files (~/.acfs/zshrc, tmux.conf), creates aliases like cc, cod, agy, and generates acfs doctor health checks, acfs info system overview, and acfs update update commands. It uses acfs.manifest.yaml as a single source of truth for all tool definitions, generating category installers and doctor_checks.sh from the manifest. The installer supports 'vibe' and 'safe' modes for passwordless sudo and agent permission skipping (vibe) or standard confirmations (safe).
- Individual developers wanting to quickly spin up a VPS for AI-assisted coding without manual setup.
- Beginners needing step-by-step guidance through the interactive wizard (agent-flywheel.com).
- Teams needing a reproducible and consistent development environment for agentic workflows.
- Users wanting to leverage the pre-installed Dicklesworthstone stack (ntm, ubs, etc.) for multi-agent coordination.
- Users wanting to customize tool installations via a centralized YAML manifest.
What are this agent's strengths and limitations?
- One-shot installation of 30+ tools and three AI agents, saving significant manual configuration time
- Manifest-driven generation ensures consistency between install logic and documentation
- Security features include preflight checks, checksum verification, HTTPS enforcement, and content hash checking
- Idempotent and resumable installation that automatically continues from the last completed phase
- Ubuntu-only (22.04+) and auto-upgrades to 25.10, which can involve reboots and significant time
- Tightly coupled to the Dicklesworthstone stack and specific agent CLIs (Claude, Codex, Antigravity), creating vendor lock-in
- 'Vibe' mode enables dangerous flags (e.g., --dangerously-skip-permissions), posing security risks
- Requires substantial VPS resources (at least 4GB RAM, 10GB disk)
How do you install or deploy this agent?
Requires a fresh Ubuntu VPS (22.04+) with SSH access. On the VPS, run: curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh?$(date +%s)" | bash -s -- --yes --mode vibe. The installer will automatically upgrade Ubuntu to 25.10 (can be skipped) and install all tools. Before running the installer, you can run a preflight check (scripts/preflight.sh) to validate the system. After installation, configure agent credentials with acfs services-setup (Claude API key, Codex login, etc.).
How do you use this agent?
After installation, use the three AI agents directly via aliases: cc (Claude Code), cod (Codex), and agy (Antigravity). Use acfs newproj to create a new project with AGENTS.md, acfs doctor for health checks, and acfs update to update all tools. Launch the interactive tutorial with onboard, and access the learning hub at agent-flywheel.com/learn. Example: on your VPS, in a project directory, run cc to start a Claude Code session.