원문 캡처 · github.com
원문 캡처 · github.com

Agent Manager는 Claude Code, Codex, Gemini CLI, opencode, Hermes, OpenClaw, fx를 브라우저에서 함께 실행하고 관리하는 비공개 작업공간이다. 여러 작업을 나란히 보거나 대화와 터미널을 확인하고, 다른 기기에서 이어서 작업할 수 있다.

각 세션은 별도의 대화를 유지한다. 같은 프로젝트에서 작업하도록 세션끼리 폴더를 공유할 수 있지만, 그룹은 화면을 정리할 뿐 파일이나 자격 증명을 격리하지 않는다. 사용자는 자신의 서비스 로그인이나 API 키를 연결해야 한다. 대화 기록을 읽는 기능은 에이전트의 기록 형식에 따라 달라진다.

Hugging Face 계정과 지원되는 코딩 에이전트가 필요하다. Agent Manager 템플릿을 복제해 Space를 비공개로 설정하고, 비공개 저장소 버킷을 /data에 읽기·쓰기 권한으로 마운트해야 한다. 에이전트에 로그인하기 전에 이 설정을 마쳐야 한다. 저장소 안내를 참고할 수 있다.

Space가 실행되면 앱의 첫 실행 안내에 따라 에이전트 세션에서 로그인하거나 API 키를 Space 비밀 값으로 추가한다. Codex는 세션에서 ‘Sign in with Device Code’를 선택해야 한다. Codex의 ChatGPT 로그인은 에이전트가 실행되는 기기의 localhost로 연결되므로 Space에서 브라우저로 접근할 수 없다.

브라우저를 닫거나 기기를 바꿔도 에이전트는 Space가 깨어 있는 동안 백엔드에서 계속 실행된다. 다만 Space가 절전·재시작·재빌드되면 실행 중인 프로세스는 종료된다. 버킷을 마운트하면 저장된 작업 파일과 체크포인트된 CLI 상태는 남고, 지원되는 세션은 다시 시작해 대화를 이어갈 수 있다. 재부팅 중 실행 중이던 셸 명령은 보존되지 않는다. 버킷이 없으면 로컬 파일과 로그인 정보는 임시로만 저장된다. 자세한 내용은 상태 체크포인트 안내와 버킷 백업 안내를 확인하면 된다.

Agent Manager 자체에는 로그인 기능이 없다. 따라서 앱에 접근할 수 있는 사람은 셸과 로그인된 에이전트를 사용할 수 있으므로 Space와 버킷을 모두 비공개로 유지해야 한다. 공개 템플릿은 설치 페이지이며, 개인정보 보호 잠금 기능은 공개된 인스턴스를 감지하는 데 도움을 준다.

Agent Manager는 Apache 2.0 라이선스로 공개됐다. 에이전트 구독이나 API 사용량, Space 하드웨어, 저장소 비용은 각 제공업체의 요금 기준을 따른다. 설정 화면에서 CLI를 업데이트하고, 토큰 사용량·예상 비용·할당량을 확인하거나 프롬프트를 예약하고 기기 알림을 켤 수 있다. 이용량 정보의 제공 범위는 서비스 제공업체에 따라 다르다.

Space와 저장소 버킷은 Python으로도 설정할 수 있다. 먼저 Hub 클라이언트를 설치하고 Space와 버킷을 만들 권한이 있는 계정으로 로그인한다.

bash
pip install -U huggingface_hub
hf auth login
python
from huggingface_hub import HfApi, Volume

api = HfApi()
username = api.whoami()["name"]
space_id = f"{username}/agent-manager"
bucket_id = f"{username}/agent-manager-data"

api.create_bucket(bucket_id, private=True, exist_ok=True)
api.duplicate_repo(
 from_id="lvwerra/agent-manager-template",
 to_id=space_id,
 repo_type="space",
 private=True,
 space_volumes=[
 Volume(type="bucket", source=bucket_id, mount_path="/data"),
 ],
)

빌드가 끝나면 https://huggingface.co/spaces/<your-username>/agent-manager를 열고 에이전트 연결을 진행한다. 기존 Space에 버킷을 연결하려면 설정 화면이나 Hub 볼륨 API 안내를 이용할 수 있다.

여러 에이전트 세션을 한눈에 보고, 파일을 편집·미리 보기하거나 업로드하고, 공유 스킬과 원격 에이전트를 활용할 수 있다. Codex 세션 공유 기능은 아직 작업 중이며, 관련 제안과 실험적 미리 보기·바인딩 파일럿이 공개돼 있다. 공유 세션 생성과 자동 마이그레이션은 기본적으로 활성화되지 않았으며, 현재 Codex 로그인 방식도 바꾸지 않는다. 자세한 내용은 Agent Manager 저장소에서 확인할 수 있다.