팀 협업

MadoHub은 Claude Code의 팀 기능과 통합되어, 팀원들의 에이전트가 무엇을 하고 있는지 실시간으로 볼 수 있게 합니다.

작동 방식

MadoHub은 ~/.claude/teams/에서 팀 구성을 읽어 활성 팀원을 찾습니다. tmux 세션에서 Claude Code 에이전트를 실행 중인 각 팀원은 캔버스의 팀 패널 타일로 표시될 수 있습니다.

팀 감지

MadoHub은 ~/.claude/teams/ 디렉터리에서 다음을 검사합니다:

• config.json — 팀 이름, 설명, 리드 에이전트 ID, 멤버 목록
• live tmux 패널이 있는 활성 멤버 필터링
• tmux list-panes로 패널 사용 가능 여부 확인

팀 패널 타일

각 팀원은 실시간으로 자신의 터미널 출력을 보여주는 팀 패널 타일을 받습니다. 이 타일에는 다음이 표시됩니다:

• 팀원 이름
• 에이전트 상태 표시기(작업 중, 대기 중, 중지됨, 유휴, 완료됨, 실패)
• tmux 패널의 라이브 터미널 출력

자동 레이아웃

팀원을 표시할 때 MadoHub은 타일을 자동으로 배치합니다:

• 1명: 캔버스 중앙
• 2명: 나란히 배치
• 3명 이상: 리드 에이전트를 중심으로 원형 배치, 원의 반지름은 타일 너비에 80px를 더한 값

팀 허브

팀 활동은 팀 허브에 표시됩니다. 이는 오른쪽 드로어에 있는 탭으로, Flows 및 Exploration과 나란히 위치합니다. 여기에는 다음이 표시됩니다:

• 멤버 상태 점 — working, waiting, stopped, completed, failed, idle의 6가지 상태 중 하나.
• 진행 중 항목을 먼저, 그다음 대기 중, 마지막으로 완료된 순으로 정렬된 작업 보드.
• 최근 3개의 팀 메시지를 최신순으로 보여주는 Messages 섹션.

팀 메시지

팀 메시지는 ~/.claude/teams/{team}/inboxes/에서 동기화됩니다. 팀 허브의 Messages 섹션에서 확인할 수 있습니다.

팀 작업

작업 목록은 ~/.claude/tasks/{team}/에서 동기화됩니다. 팀 허브의 작업 보드에서 팀 전체의 공유 작업을 추적할 수 있습니다.

요구 사항

• 팀원은 tmux 세션에서 Claude Code를 실행 중이어야 합니다.
• ~/.claude/teams/ 디렉터리에는 유효한 팀 구성이 있어야 합니다.
• tmux가 설치되어 있고 접근 가능해야 합니다.