Agentic Coding Flywheel Setup (ACFS)

This project addresses the significant barrier to entry for AI-powered coding environments by automating the setup of a fully configured Ubuntu VPS. It targets both beginners, who are guided through the process via a wizard website, and experienced developers, who can deploy a robust agentic coding stack with a single command. The primary benefit is reducing the setup time from hours to under 30 minutes, enabling rapid experimentation and productivity with AI coding agents.

How It Works

ACFS employs a manifest-driven architecture, with acfs.manifest.yaml serving as the single source of truth for all installed tools. A TypeScript generator parses this manifest to produce installer scripts and verification checks. The core installation is a curl | bash one-liner that orchestrates the setup of over 30 tools, including multiple AI coding agents (Claude Code, Codex CLI, Gemini CLI), language runtimes, developer utilities, and a specialized 8-tool "Dicklesworthstone Stack" for agent coordination. The installer is idempotent, checkpointed, and designed to resume automatically from failures.

Quick Start & Requirements

• Primary Install Command:

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

  (Use tagged releases for production stability, e.g., ACFS_REF=v0.1.0 ... | bash -s -- ...)
• Prerequisites:
  • OS: Ubuntu 22.04+ VPS (automatically upgrades to 25.10).
  • RAM: 48-64GB recommended for multi-agent workloads.
  • CPU: 16 vCPU recommended.
  • Storage: 300GB+ NVMe SSD recommended.
• Links:
  • Wizard Website: agent-flywheel.com
  • GitHub Repo: Dicklesworthstone/agentic_coding_flywheel_setup

Highlighted Details

• Zero to Hero Setup: Transforms a fresh VPS into a fully-armed agentic coding environment in under an hour, often as little as 30 minutes.
• "Vibe Mode": Pre-configured for maximum velocity on throwaway VPS instances, enabling passwordless sudo and dangerous agent flags.
• Dicklesworthstone Stack: Includes 8 specialized tools (NTM, Agent Mail, UBS, etc.) for advanced agent orchestration, coordination, and safety.
• Automated Ubuntu Upgrade: Seamlessly upgrades the OS to Ubuntu 25.10, potentially taking 1.5-3 hours with multiple reboots.
• Security Verification: Implements HTTPS enforcement and SHA256 checksum verification for all downloaded upstream scripts.
• Interactive Onboarding: A 9-lesson TUI tutorial guides users through installed tools and agentic workflows.

Maintenance & Community

The author explicitly states they do not accept outside contributions due to bandwidth limitations but welcomes issues and PRs for review. No community links (Discord/Slack) are provided.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Designed for Ubuntu VPS. Not intended for local macOS/Windows machines. "Vibe Mode" is explicitly insecure and not for production or shared environments.

Limitations & Caveats

ACFS is designed for ephemeral Ubuntu VPS instances; there is no uninstall script, requiring VPS recreation for removal. The automated Ubuntu upgrade process can be lengthy (1.5-3 hours) and involves multiple reboots. "Vibe Mode" intentionally reduces security for speed and should not be used on sensitive systems.