정의
Shann³이 공개한 Hermes Agent VPS 설정 패턴. 노트북이나 휴대폰에서 10초 안에 접속해 프로젝트별 격리된 에이전트를 띄울 수 있는 단일 폴더 컨트롤 스테이션 구조. 모든 컨텍스트가 VPS의 한 폴더에 집결한다.
핵심 속성
- 접속 흐름:
ssh hermes별칭 → CMUX 터미널 고정 세션 → SSH 내부에서 Claude Code 세션 → 컨트롤 스테이션 폴더에서 모든 명령 실행 - 단일 폴더 구조 (
vps-agents/):README.md— 전체 개요 + 사용 방법CLAUDE.md— Claude Code 자동 로드 컨텍스트agents/hermes-main/— 에이전트별 운영 문서 5종 (inventory, docker, runbook, env-map, backup)shared/— VPS 전역 보안 체크리스트, Docker/Hermes/UFW 치트시트
- 격리 단위: 프로젝트별 Docker isolated agent + 서브 프로파일 (sub-profile)
- 백업 전략: GitHub로 자동 백업, 어디서든 복구 가능
- 접근성: 노트북·휴대폰에서 10초 이내 접근
폴더 구조
vps-agents/
├── README.md # 전체 개요 + 사용 방법
├── CLAUDE.md # Claude Code 자동 로드 컨텍스트
├── agents/hermes-main/
│ ├── inventory.md # IP, hostname, 운영 위치, 소유자
│ ├── docker.md # docker-compose 초안 + first-boot 체크리스트
│ ├── runbook.md # 7가지 장애 시나리오 대응
│ ├── env-map.md # 키 위치 매핑 (값은 비공개)
│ └── backup.md # GitHub 백업 + 복구 절차
└── shared/
├── security.md # VPS 전역 하드닝 체크리스트
└── commands.md # Docker / Hermes / UFW 치트시트
관계
- 20260515-agent-team-operating-layer — 상위개념: 에이전트팀 운영 레이어의 1인용 버전
- 20260515-harness-knowledge-hook-three-pillars — 연장: 하네스 세 기둥 중 “knowledge” 레이어의 구체 구현
- 20260526-one-folder-pkm-system — 대조: 같은 “단일 폴더” 원칙의 PKM 버전
인용
from this session I can spin up new docker-isolated agents per area and each one can have sub-profiles. the whole stack is documented, backed up to GitHub, and accessible from anywhere