FonaTech/Clouds-Coder

Clouds Coder is a local-first coding agent platform centered on separating the CLI execution plane from the Web user plane, with Web UI, Skills Studio, resilient streaming, and long-task recovery controls.

Clouds Coder – 무엇인가요

Clouds Coder는 로컬 또는 클라우드 호스트에서 명령줄 도구(CLI 실행 평면)를 실행하면서 풍부한 브라우저 기반 IDE(웹 사용자 평면)를 통해 프로세스와 상호작용할 수 있는 Python 기반 런타임입니다. 이는 일반적인 AI 에이전트를 기반으로 하며, 여러 사람이 서로의 작업을 방해하지 않고 동일한 프로젝트에 함께 작업할 수 있도록 LAN 전체 협업 모드를 추가합니다.

핵심 아이디어는 중량 작업(예: git, make, docker, 사용자 정의 스크립트)을 사용자 인터페이스에서 분리하는 것입니다. 이를 통해 다음과 같은 이점을 얻을 수 있습니다:

관찰 가능하고 재현 가능한 실행(완전한 로그, 디버그 콘솔, 터미널 출력);
파일 단위의 히스토리가 있는 버전 관리된 워크스페이스;
사용자 요청을 에이전트용 더 풍부하고 깊이 예산이 있는 계획으로 확장하는 "프롬프트 엔ハン서";
세밀한 보안 – 모든 도구 호출은 특정 워크스페이스에서 실행되기 전에 관리자의 승인이 필요합니다.

주요 구성 요소 (README에 설명됨)

구성 요소	기능
런타임 (CLI 실행 평면)	임의의 명령어를 실행하고, Python `debugpy` 또는 `pdb`를 사용해 디버깅하며 결과를 UI로 피드백합니다.
브라우저 IDE	Monaco 기반 에디터, 파일 탐색기, 터미널, 디버그 콘솔, 그리고 에이전트 채팅, 작업 블랙보드, 진단 패널을 포함합니다.
Liquid Kernel	변경 불가능한 제어 평면으로, 서명된 도구 정책, 프롬프트 정책, 라이프사이클 훅(`before_run`, `before_round`, `after_tool_results`)을 저장합니다. 카나리 배포 및 롤백을 처리합니다.
협업 모드 (LAN)	기본적으로 `P+7`를 사용하는 별도의 리스너로, 관리된 프로젝트 워크스페이스를 호스팅합니다. 승인된 장치는 비밀번호 + 장치 키 흐름을 통해 참여하며, 24시간 HttpOnly 세션을 얻고, 리비전된 파일, 존재 상태, 공유 작업 블랙보드를 확인할 수 있습니다.
에이전트 오케스트레이션	세션 내에서 에이전트는 역할(`manager`, `explorer`, `developer`, `reviewer`)을 수행합니다. 프로젝트 전체에서는 코디네이터 에이전트가 작업을 분할하고, 기여자 에이전트가 겹치지 않는 부분을 실행합니다.
프롬프트 엔핸서	설정 가능한 깊이 예산(`Low` → `XHigh`)을 가진 단일 실행 또는 지속적 프롬프팅입니다. LLM에 요청을 전달하기 전에 워크스페이스 인식과 선택적 기술 오케스트레이션을 추가합니다.
보안 및 신뢰 경계	관리자는 장치를 승인하고, 허용되는 MCP(모델 제어 프로세스) 명령어를 정의하며, SQLite에 저장된 레지스트리에 서명합니다. 승인된 구성이 변경되면 기존 승인은 무효화됩니다.
리비전 인식 쓰기 프로토콜	텍스트 편집은 운영 변환을 사용하고, 바이너리/전체 파일 쓰기는 낙관적 동시성 제어를 사용하며, 쉘/에이전트 프로세스는 변이 레이스를 획득하여 다중 파일 업데이트의 원자성을 보장합니다.

일반적인 워크플로우

런타임 시작 – python Clouds_Coder.py --host 0.0.0.0 --port 8080 (런타임은 8080, IDE는 8085, 협업은 8087).
IDE 열기 – http://127.0.0.1:8085로 이동합니다. IDE는 세션 워크스페이스, 에디터, 터미널, 그리고 에이전트 채팅 패널을 표시합니다.
에이전트에게 요청하기 – 고수준 목표(예: "Docker와 함께 Flask 프로젝트 설정")를 입력합니다. 프롬프트 엔핸서가 요청을 확장하고, 에이전트가 단계를 계획하며, 런타임이 CLI 명령어를 실행하면서 IDE로 출력을 스트리밍합니다.
협업하기 – --enable_collaboration을 활성화합니다. 관리자 UI(/admin → Collaboration)를 통해 팀원을 초대합니다. 장치 승인 후 팀원은 프로젝트 URL(P+7)을 열고 동일한 리비전된 파일, 공유 블랙보드, 그리고 서로의 존재 상태를 확인할 수 있습니다.
경합 해결하기 – 두 에이전트가 동일한 파일을 수정하려 할 경우, 시스템은 후보 브랜치를 생성하고 베이스라인을 동결하며, 병합 전에 두 명의 서로 다른 구성원의 검토를 강제합니다.
감사 및 롤백하기 – 모든 작업은 서명되어 변경 불가능한 SQLite 감사 체인에 저장됩니다. 관리자는 카ーネル 버전을 롤백하거나 이전 프로젝트 스냅샷을 복원할 수 있습니다.

누구에게 적합한가요?

CLI를 제어하는 에이전트를 테스트할 수 있는 AI 에이전트 개발자.
모든 명령어를 관찰 가능하고 감사 가능한 저부하 LAN 전용 협업 IDE를 원하는 개발 팀.
"바이브 코딩"(AI를 코드 작업을 안내하면서 터미널과 파일 변경을 실시간으로 관찰하는 실습)을 가르치는 교육자/연구실.
모든 도구 호출에 명시적인 승인이 필요하고 완전한 감사 추적이 필요한 보안에 민감한 조직.

설치 및 빠른 시작 (README에서)

pip install clouds-coder   # 최신 PyPI 릴리스를 다운로드
# 포트 8080에서 런타임 시작 (IDE는 8085, 협업은 8087)
python Clouds_Coder.py \
  --host 0.0.0.0 \
  --port 8080 \
  --enable_collaboration \
  --collab_host 0.0.0.0 \
  --collab_port 8087

IDE는 http://127.0.0.1:8085에서 열립니다.
관리자 UI http://127.0.0.1:8080/admin에서 프로젝트를 생성하고, 비밀번호를 설정하며, 장치를 승인합니다.
프로덕션 LAN 사용 시 --collab_tls_cert/--collab_tls_key를 제공하거나, HTTPS 리버스 프록시를 앞에 배치하세요.

더 알아보기

변경 로그 – 상세한 기능 이력은 log/CHANGELOG‑*.md에 기록되어 있습니다 (예: 2026-09-12 "Liquid Kernel & Scalable Session Runtime" 변경 로그).
LLM 설정 템플릿 – LLM.config.json은 서버 사이드 LLM 프로파일, 기술, RAG 리소스를 통합하는 방법을 보여줍니다.
아키텍처 다이어그램 – README에는 런타임, 제어 평면, 협업 경계를 설명하는 Mermaid 플로우차트가 포함되어 있습니다.

결론

Clouds Coder는 실제로 사용 가능한, 프로덕션 수준의 플랫폼입니다. AI 기반 CLI 실행자와 웹 기반 IDE, 그리고 관리된 LAN 협업 계층을 결합합니다. 복잡한 명령줄 작업을 여러 인간과 에이전트 참여자가 관찰 가능하고 재현 가능하며 안전하게 수행할 수 있도록 하는 데 초점을 맞추고 있습니다.