Mission Control: Claude Code 서브에이전트와 도구 호출을 실시간으로 보기

Mission Control은 Hamza Zafar(hamzafer)가 만든 커뮤니티 모드로, 그의 claude-code-mods 컬렉션에 속해 있습니다. 메인 에이전트와 Claude Code 서브에이전트, 그리고 이들이 하는 모든 도구 호출을 한곳에서 보여 주어 Claude Code가 무엇을 하고 있는지 알 수 있게 합니다. /mission을 실행하면 채팅 옆에 트리가 있는 패널이 열립니다. 메인 루프가 맨 위에 있고, 각 Claude Code 서브에이전트가 그 아래에 달리며, 도구 호출은 그 호출을 한 에이전트 아래에 놓입니다. 같은 도구의 연속 호출은 read: README.md → src/login.js ×2처럼 한 줄로 접히고, 각 줄에는 소요 시간이 표시됩니다.

Claude가 작업하는 동안과 그 후 30초 동안에는 프롬프트 위의 한 줄이 상황을 요약합니다. ◈ mission: 2 tools 같은 형태이며, 에이전트나 변경된 파일이 있으면 그 개수도 붙습니다. 두 번째 보기인 /mission code는 Claude가 읽거나 편집한 파일의 맵을 그립니다. 파일 사이의 상대 import는 화살표로, 지금 다루고 있는 파일은 빛나는 효과로 표시되며, 각 변경에는 한 줄 메모가 붙습니다. 작성자의 README에 따르면 이 컬렉션에는 Claude Code 2.1.287 이상이 필요하며, 저희는 2.1.296에서 테스트했습니다.

녹화 영상에서는 작은 데모 프로젝트에서 모드를 불러온 채 Claude Code를 시작하고, Claude에게 README.md와 src/login.js를 읽고 각각 무엇을 하는지 한 문장으로 말해 달라고 요청합니다. Claude가 두 파일을 읽는 동안 프롬프트 위 띠의 줄이 도구 수를 셉니다. 답변이 끝나면 영상에서 /mission을 입력합니다. 패널이 프롬프트 위에 열리며 Who, Code, Close 버튼, 0 agents (0 running) · 2 tool calls 요약, 프롬프트 텍스트가 담긴 초록색 메인 줄, 그 아래 접힌 read: demo-app/README.md → src/login.js ×2 줄이 표시됩니다. 코드 맵은 영상에 나오지 않습니다.

설치 블록의 방법 중 아무것이나 사용하십시오. 모두 작성자 자신의 마켓플레이스에서 바로 설치합니다. 그런 다음 세션에서 /mission을 실행하십시오. 이미 열려 있는 세션에 설치했다면 먼저 /reload-plugins를 실행하십시오.

모드는 트리, 파일 목록, 현재 보기를 호스트가 보관하는 $.state 아톰에 저장하므로 핫 리로드 후에도 화면이 유지됩니다. 모든 도구 호출은 tool.call 훅으로 감싸지며, 훅은 노드를 추가하고 호출을 실행시킨 뒤 완료 또는 실패로 표시합니다. hooks/register.tsx의 코드는 다음과 같습니다.

let failed = true
let r: Awaited<ReturnType<typeof next>>
try {
  r = await next(e)
  failed = r.deny !== undefined || r.isError === true
} finally {
  await update($, nodes, list => list.map(n => (n.id === id ? { ...n, status: failed ? 'failed' : 'done', end: Date.now() } : n)))
}

agent.spawn은 서브에이전트를 추가하고, turn.start는 트리를 초기화하며, turn.complete는 아직 실행 중으로 표시된 것을 닫습니다. Agent 호출과 Claude Code 자체의 관리용 도구(ToolSearch, TaskCreate 등)는 제외됩니다. 1초 간격의 시계는 무언가 실행 중일 때만 화면을 갱신하며, 트리는 최대 300개 노드로 제한됩니다. 코드 맵의 경우 hooks/map.ts가 SVG를 만듭니다. 건드린 각 소스 파일을 $.fs.read로 읽고, 정규식으로 상대 import를 찾은 뒤, import 깊이에 따라 파일을 열로 배치합니다. SVG는 헤드리스 Chrome으로 PNG로 변환되어 패널의 Image 요소로 표시됩니다.

/config에는 옵션이 없습니다. 조작 수단은 /mission, /mission who, /mission code와 패널 버튼 w, c, q뿐입니다. 동작을 바꾸려면 register.tsx 맨 위의 상수를 수정하십시오. MAX_NODES(트리 크기), MAX_FILES(맵에 표시할 파일 수), BAND_AFTER_MS(띠가 남아 있는 시간), INTERNAL(트리에서 제외할 도구), CODE_FILE(맵에 나타나는 파일 형식)입니다.

저희는 실행하기 전에 플러그인이 실행할 수 있는 모든 파일을 읽었습니다. .claude-plugin/plugin.json, hooks/hooks.json, hooks/register.tsx, hooks/map.ts, hooks/tree.ts, 타입 선언, 테스트입니다. package.json, 설치 스크립트, 바이너리, 번들된 코드는 없으며, 숨겨진 유니코드, eval, 원격 코드도 발견하지 못했습니다.

• 네트워크: 모드 자체는 사용하지 않습니다. fetch, 소켓, 호스트가 없습니다.
• 모델 호출: 메인 턴에서 파일을 편집하거나 쓴 뒤, register.tsx의 explain()이 model: 'haiku'로 $.model.complete를 호출합니다. 프롬프트에는 각 old_string과 new_string이 최대 300자(쓴 파일은 400자) 들어가며, 응답은 맵 위의 최대 80자 메모가 됩니다. 응답은 JSON으로 파싱되고, 잘리고, 이스케이프된 뒤에 SVG에 들어갑니다. 세션의 사용량 한도를 씁니다.
• 프로세스: $.process.run을 통해 sh -c 스크립트 하나를 실행합니다. 이 스크립트는 일회용 프로필로 헤드리스 Chrome을 시작하고, 스크린샷을 기다린 뒤, 그 Chrome을 종료합니다. 파일 및 폴더 이름은 셸 문자열에 끼워 넣지 않고 인자로 전달됩니다. Chrome은 패널이 코드 보기로 열려 있을 때만 시작됩니다.
• 파일 쓰기: $TMPDIR/mission-control/에만 씁니다. map.svg, map-N.png 파일 두 개, Chrome 프로필 폴더입니다. ~/.claude, 설정, 셸 파일, LaunchAgents에는 아무것도 쓰지 않습니다. 모드는 import를 찾기 위해 Claude가 건드린 파일을 읽고, 편집 조각은 메모리에 보관합니다.
• 데몬: 없습니다. 1초 간격의 시계는 세션과 함께 멈추고, Chrome은 스크린샷마다 종료됩니다.
• 비밀 정보 및 환경: TMPDIR만 읽습니다.
• 텔레메트리: 없습니다.
• 프롬프트 영향: additionalContext를 추가하지 않으며, 프롬프트나 도구 결과를 다시 쓰지 않습니다.
• 게이팅 훅: tool.call과 agent.spawn을 감싸며, claude plugin validate는 이를 .catch가 없는 게이팅 훅으로 표시합니다. 이 훅들은 관찰만 합니다. tool.call은 도구 결과를 바꾸지 않고 돌려주며 인자도 바꾸지 않습니다.
• 외부 요구 사항: 코드 맵에는 /Applications/Google Chrome.app(macOS 경로)의 Google Chrome이 필요합니다. Who 보기에는 필요하지 않습니다.
• 라이선스: MIT이며 LICENSE 파일이 있습니다.

claude plugin validate는 오류나 경고를 보고하지 않았고, 작성자의 테스트 7개가 Claude Code 2.1.296에서 모두 통과했습니다.

macOS에서 Claude Code 2.1.296으로 확인했습니다(validate, 테스트, 녹화). 문제가 있으면 다음을 확인하십시오.

• /mission이 알 수 없는 명령으로 나옵니다. /plugin에서 플러그인이 로드되었는지 확인하고, 새로 설치한 뒤에는 /reload-plugins를 실행하십시오.
• 코드 맵에 Google Chrome이 필요하다고 나옵니다. /Applications/Google Chrome.app에 Chrome을 설치하십시오. 모드는 이 경로만 확인합니다.
• "Nothing yet"이 표시됩니다. 트리는 턴이 실행되면서 채워집니다. 작업을 시작하면 줄이 나타납니다.
• 터미널 밖에서는 맵이 없습니다. 다른 화면에서는 코드 맵이 터미널에서 그려진다는 안내가 패널에 표시됩니다.
• 띠의 줄이 보이지 않습니다. Claude가 작업하는 동안과 그 후 30초 동안에만 표시되며, 설문이 열려 있을 때는 표시되지 않습니다.