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)

무엇인가요 – 새 Ubuntu 또는 Arch VPS를 즉시 사용 가능한 "에이전트형 코딩" 워크스테이션으로 전환하는 Bash 기반 설치 프로그램입니다. 단일한 idempotent한 curl | bash 명령어로 완전한 개발 스택(쉘, 런타임, 클라우드 CLI 등)과 세 가지 AI 코딩 에이전트(Claude Code, Codex CLI, Antigravity CLI)를 한 번에 설치합니다.

왜 중요한가요 – 이 리포지토리는 "AI 지원 프로그래밍" 워크플로우에 필요한 전체 툴체인을 패키징하고, 개인, 팀, 또는 교실 랩에서 재현 가능한 설치를 가능하게 합니다. 매니페스트 파일에 인벤토리를 정의하고, 이를 기반으로 설치 스크립트를 생성함으로써 감사 가능성과 간편한 업데이트를 목표로 합니다.

핵심 구성 요소 (README에 설명됨)

구성 요소	경로	기술	역할
매니페스트	`acfs.manifest.yaml`	YAML	유일한 진실 소스 – 모든 도구, 설치 명령어, 검증 단계를 나열
생성기	`packages/manifest/src/generate.ts`	TypeScript + Bun + Zod	매니페스트를 분석하고 검증한 후 Bash 카테고리 라이브러리, 도ctor 체크, 하드웨어를 생성
웹 위저드	`apps/web/`	Next.js 16 + Tailwind 4	초보자가 VPS를 렌탈하고, SSH 키를 생성하며, 설치 프로그램을 실행하는 데 도움을 주는 인터랙티브한 13단계 가이드
설치 프로그램	`install.sh`	Bash	프로덕션용 원라인; 생성된 라이브러리를 소스로 불러와 단계별 설치를 조율
라이브러리 스크립트	`scripts/lib/`	Bash	보안, 체크섬 검증, 헬스 체크, 업데이트 등 재사용 가능한 함수
생성된 스크립트	`scripts/generated/`	Bash (소스만)	카테고리별 설치 모듈, 도ctor 체크, 매니페스트 인덱스, 체크섬 레지스트리
설정 파일	`acfs/`	쉘/Tmux 파일	사용자 수준의 dotfiles (`.zshrc`, `tmux.conf`, 온보딩 레슨)을 `~/.acfs/`에 배포
체크섬	`checksums.yaml`	YAML	모든 외부 설치 스크립트의 SHA-256 해시; 보안 라이브러리에서 사용

설치 프로그램 작동 방식 (고수준 흐름)

사용자가 원라인(curl … | bash …)을 실행합니다.
install.sh가 생성된 카테고리 라이브러리를 소스로 불러옵니다.
매니페스트의 phase 순서에 따라 각 모듈에 대해 지정된 install 명령어를 필요한 사용자(보통 root)로 실행합니다.
모듈이 완료된 후 해당하는 verify 명령어가 실행되며, 실패 시 실행을 중단합니다.
모든 외부 설치 프로그램은 HTTPS를 통해 다운로드되며, checksums.yaml의 SHA-256 해시와 비교( scripts/lib/security.sh를 통해)된 후에만 실행됩니다.
성공적으로 완료되면 VPS에는 다음이 설치됩니다:
- 모던한 쉘 (zsh, oh-my-zsh, powerlevel10k)
- 언어 런타임 (bun, uv/Python, Rust, Go)
- 클라우드 CLI (Vault, Wrangler, Supabase, Vercel 등)
- 에이전트 조율 도구 (NTM, MCP Agent Mail, SLB 등)
- 명령줄에서 호출할 수 있는 상태의 세 가지 AI 코딩 에이전트

README에서 강조된 주요 기능

원라인, idempotent – 안전하게 재실행 가능; 마지막 완료된 단계에서 재개.
"Vibe" 모드 – 속도 최적화를 위한 사전 설정(비밀번호 없이 sudo, 적극적인 에이전트 플래그).
위저드 웹사이트 – 초보자가 SSH 키 생성, VPS 렌탈, 설치 프로그램 실행까지 안내받음.
매니페스트 기반 생성 – 도구를 추가하려면 acfs.manifest.yaml만 수정하면 됨. TypeScript 생성기가 모든 Bash 모듈을 자동으로 업데이트.
체크섬 기반 보안 – 모든 외부 스크립트는 실행 전 저장된 SHA-256 해시와 검증됨.
재현 가능한 팀 환경 – --ref를 사용해 태그나 커밋에 고정하면, 모든 머신에서 동일한 설치를 보장.

일반적인 사용 사례

대상	얻는 것
초보자	단계별 웹 위저드, AI 에이전트가 코드를 작성할 수 있는 상태의 VPS
개인 개발자	새 VM에 전체 스택과 세 가지 코딩 에이전트를 제공하는 단일 명령어. 수 시간의 수동 설정을 절약
팀 / 교실	릴리스에 고정된 설치로 모든 구성원의 환경이 완전히 일치. 에이전트 워크플로우에서 "내 머신에서는 작동해" 문제를 제거

시작하기 (README에서)

# 빠른 설치 (기본적으로 vibe 모드)
{ 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 코딩 환경을 자동화하는 구체적이고 오픈소스의 부트스트랩 도구입니다. 매니페스트 기반 아키텍처, 체크섬 검증, 초보자 친화적 위저드로 인해 "에이전트형 코딩" 분야에 진정한 기여를 합니다.