에이전틱 에이전트
개요
에이전틱 에이전트 섹션은 프로젝트 내 핵심 AI 워크스페이스입니다. CLI 기반, SDK 기반, ACP 기반 에이전트 탭을 생성하고 관리할 수 있습니다. 각 탭은 독립적인 AI 에이전트 세션을 실행하므로 여러 에이전트 또는 대화를 동시에 작업할 수 있습니다.
Kaiju Hub AI에는 Anthropic Claude Code, Google Gemini, OpenAI Codex에 대한 기본 지원이 포함되어 있습니다. Pro 버전은 OpenCode와 같은 사용자 정의 CLI 추가도 지원합니다.
기본적으로 열리는 에이전트는 프로젝트 정보 영역에서 선택한 공급자와 모드에 의해 결정됩니다. + 버튼을 왼쪽 클릭할 때마다 해당 기본 설정을 사용하여 새 탭이 열립니다.
Kaiju Hub AI 컨텍스트 시스템
작동 방식
Kaiju Hub AI은 AI 에이전트와 통신하기 위해 고유한 컨텍스트 번들링 시스템을 사용합니다. 원시 메시지를 직접 보내는 대신, 전송하는 모든 프롬프트가 AI가 단일 패키지로 읽는 구조화된 컨텍스트 파일로 번들됩니다. 이 번들에는 프롬프트 텍스트, 첨부된 이미지, 첨부 파일, 포함된 블록 또는 프로젝트 참조가 포함됩니다.
메시지를 보내면 Kaiju Hub AI이 이 모든 조각을 하나의 번들 파일로 조합하여 AI 에이전트에 전달합니다. 에이전트는 전체 번들을 한 번에 읽어 단일 정리된 컨텍스트에서 첨부한 모든 것에 대한 완전한 접근 권한을 갖게 됩니다.
번들되는 내용
프롬프트 텍스트
AI 에이전트에 대한 메시지가 주요 지시사항으로 포함됩니다.
첨부 이미지
첨부하는 모든 이미지가 번들에 포함됩니다. 적은 수로 제한되지 않으며 — 단일 메시지에 많은 이미지를 보낼 수 있습니다.
첨부 파일
첨부하는 파일이 번들되어 AI가 내용을 직접 읽고 참조할 수 있습니다.
프로젝트 참조
프로젝트 허브에서 프로젝트를 첨부하면 경로가 포함되어 AI가 해당 프로젝트를 직접 참조하고 작업할 수 있습니다.
블록 참조
블록 라이브러리의 블록을 메시지에 첨부할 수 있습니다. AI가 컨텍스트의 일부로 블록 콘텐츠를 읽고 활용합니다.
크로스 세션 메모리
전송된 모든 번들은 백엔드에 저장됩니다. 이를 통해 AI는 같은 세션 내 이전 탭의 컨텍스트를 참조할 수 있으며, 이전 채팅 세션 전체를 되돌아볼 수도 있습니다. 예를 들어, 지난주에 특정 기능에 대한 대화를 했다면 AI가 논의한 내용과 요청한 내용을 기억할 수 있습니다.
이 크로스 세션 메모리는 모든 탭에서 작동합니다. 한 탭에서 무언가를 보내면 AI가 다른 탭이나 향후 세션에서 참조할 수 있도록 컨텍스트가 제공됩니다.
이것이 중요한 이유
토큰 사용량 감소
원시 기록을 추가하는 대신 구조화된 파일로 컨텍스트를 번들링하여 토큰 소비를 크게 줄입니다.
더 많은 컨텍스트 자료
일반적인 제한에 도달하지 않고 훨씬 더 많은 컨텍스트 — 많은 이미지, 여러 파일, 프로젝트 참조, 블록 — 를 포함할 수 있습니다.
영구 기록
AI가 세션 전체에 걸쳐 과거 대화의 인식을 유지하므로 반복하거나 이전 작업을 다시 설명할 필요가 없습니다.
탭 추가
개요
에이전트 도구 모음의 + 버튼을 사용하여 새 에이전트 탭을 만들 수 있습니다. + 버튼을 왼쪽 클릭하면 프로젝트 정보 영역에서 선택한 기본 에이전트를 사용하여 새 탭이 즉시 열립니다. + 버튼을 오른쪽 클릭하면 특정 에이전트 유형을 선택할 수 있는 드롭다운 메뉴가 열립니다.
지원되는 에이전트 유형
Markdown 뷰어
개요
Markdown 뷰어 탭은 에이전트 영역 내에서 markdown 콘텐츠를 렌더링합니다. 외부 편집기로 전환하지 않고 워크스페이스에서 직접 서식이 지정된 문서, 에이전트 지시사항, 스킬 파일, 기타 markdown 기반 콘텐츠를 표시하는 데 사용됩니다.
기능
풍부한 렌더링
제목, 목록, 구문 강조가 있는 코드 블록, 테이블, 링크, 이미지를 포함한 전체 markdown 구문을 지원합니다.
에이전트 문서
에이전트 지시 파일(CLAUDE.md, agents/*.md, skills/*/SKILL.md)을 읽기 쉬운 형식으로 봅니다.
인라인 표시
콘텐츠가 에이전트 탭 영역 내에서 인라인으로 렌더링되어 활성 에이전트 세션과 함께 문서를 읽을 수 있습니다.
에이전트 영역
개요
에이전트 영역은 AI 에이전트와 상호작용하기 위한 주요 워크스페이스입니다. 채팅 메시지를 표시하고, 구문 강조로 코드를 렌더링하며, 파일 및 컴포넌트 컨텍스트를 보여주고, 대화 관리를 위한 컨트롤을 제공합니다. 각 에이전트 탭에는 자체 독립 에이전트 영역이 있습니다.
탭 컴포넌트
코드 터미널 탭
CLI 기반 에이전트(Claude Code, Gemini CLI, Codex CLI)용. 에이전트가 명령을 실행하고 실시간으로 출력을 표시하는 터미널과 같은 인터페이스를 보여줍니다.
SDK 채팅 탭
SDK 기반 에이전트(Claude SDK, Gemini SDK, OpenAI SDK)용. 에이전트와 상호작용하기 위한 대화형 채팅 인터페이스를 제공합니다.
ACP 채팅 탭
ACP (Agent Communication Protocol) 에이전트용. 동적 프로토콜 기반 에이전트와 통신하기 위한 전문 채팅 인터페이스.
에이전트 및 스킬 탭
현재 프로젝트의 에이전트 기능, 커스텀 에이전트, 스킬 정의를 탐색하고 관리합니다.
세션 기록 패널
현재 에이전트 유형의 모든 과거 세션 로그를 보고, 이전 대화를 로드하고 검토할 수 있습니다.
이미지 갤러리
현재 프로젝트 세션 중 AI 에이전트가 생성한 이미지를 탐색합니다.
컨텍스트 기록
개요
컨텍스트 기록 패널은 프로젝트 전체에서 AI 에이전트와 공유된 모든 컨텍스트를 추적합니다. 컨텍스트를 내부 및 외부 소스로 분리하여 에이전트가 접근한 정보에 대한 완전한 가시성을 제공합니다.
컨텍스트 유형
내부 컨텍스트
프로젝트 내부에서 생성된 컨텍스트 — 선택된 파일, 체크된 코드, 컴포넌트 선택, 채팅 세션 중 에이전트에 명시적으로 제공한 파일 콘텐츠.
외부 컨텍스트
프로젝트 외부의 컨텍스트 — 웹 검색 결과, 가져온 URL, 임포트된 문서, 에이전트가 참조했거나 첨부한 기타 외부 데이터 소스.
기능
시간순 로그
컨텍스트 항목이 시간순으로 나열되어 무엇이 언제 공유되었는지 추적할 수 있습니다.
파일 레지스트리
내부 파일 레지스트리가 향상된 메타데이터와 각 파일의 고유 ID를 포함하여 에이전트와 공유된 모든 파일을 추적합니다.
컨텍스트 표시기
채팅 입력 영역에 현재 첨부된 파일 수를 표시하는 컨텍스트 표시기가 있어 항상 활성 컨텍스트를 알 수 있습니다.
컨텍스트 모달
컨텍스트 표시기를 클릭하여 모든 현재 컨텍스트 — 파일, 컴포넌트, 프로젝트 — 를 항목 추가 또는 제거 옵션과 함께 보여주는 상세 모달을 엽니다.
내부 및 외부
개요
에이전트 도구 모음의 내부/외부 토글은 커스텀 에이전트를 포함한 CLI 기반 에이전트의 실행 방법을 제어합니다. 에이전트가 내장 워크스페이스 터미널 내에서 실행되는지 시스템의 별도 외부 터미널 창에서 실행되는지를 결정합니다.
모드
내부
에이전트가 내장 워크스페이스 터미널 내에서 실행됩니다. 출력이 에이전트 영역 내에서 인라인으로 표시되며, 세션은 Kaiju Hub AI에 의해 완전히 관리됩니다.
외부
에이전트가 별도의 시스템 터미널 창에서 실행됩니다 (예: PowerShell, Terminal, iTerm). 전체 터미널 환경이 필요하거나 다른 명령줄 도구와 함께 에이전트를 실행하려는 경우 유용합니다.
셸 선택기
외부 모드에서는 사용할 셸을 선택할 수 있는 드롭다운이 나타납니다 (예: PowerShell, Command Prompt, Git Bash). 선택한 셸은 외부 CLI 에이전트 세션을 시작할 때 사용됩니다.
향상된 채팅 입력
개요
향상된 채팅 입력은 에이전트 워크스페이스 하단의 주요 입력 영역입니다. 단순 텍스트 박스를 넘어 이미지 첨부, 화면 녹화, 파일 첨부, 컴포넌트 선택, 음성 입력, AI 컨텍스트를 위한 세밀한 권한 컨트롤을 제공합니다.
첨부 버튼
갤러리 (이미지 컬렉션)
메시지에 포함할 이미지를 탐색, 선택, 업로드할 수 있는 이미지 업로드 모달을 엽니다. 썸네일과 드래그 앤 드롭 업로드를 통한 다중 선택을 지원합니다.
이미지 팝업 모달
첨부된 이미지 썸네일을 클릭하여 전체 크기 중앙 오버레이 뷰어에서 엽니다. X 버튼을 클릭하거나 모달 외부를 클릭하여 닫습니다.
화면 녹화
채팅 입력에서 직접 화면 녹화를 캡처합니다. 녹화기는 구성 가능한 FPS(30 또는 60)로 프레임을 캡처하고, 프레임 수와 지속 시간을 추적하며, 메타데이터가 포함된 매니페스트를 생성합니다. 녹화된 프레임을 시각적 컨텍스트를 위해 메시지에 첨부할 수 있습니다.
파일 첨부
클립 아이콘을 사용하여 프로젝트 파일을 메시지에 직접 첨부합니다.
워크스페이스 컨텍스트
브레인 아이콘을 사용하여 워크스페이스 컨텍스트를 추가합니다 — 더 풍부한 AI 이해를 위해 프로젝트 파일과 메타데이터가 포함됩니다.
컴포넌트 선택
퍼즐 아이콘을 사용하여 라이브러리에서 컴포넌트나 블록을 선택하여 컨텍스트로 포함합니다.
컨텍스트 포함
개요
컨텍스트 포함 버튼은 채팅 입력 영역 왼쪽 사이드바의 첫 번째 아이콘입니다. AI 에이전트에 메시지를 보내기 전에 체크된 파일, 선택된 컴포넌트, 워크스페이스 메타데이터와 같은 프로젝트 컨텍스트를 메시지에 첨부할 수 있습니다.
사용 방법
왼쪽 클릭
다음 메시지에 포함할 파일과 프로젝트 컨텍스트를 탐색하고 선택할 수 있는 컨텍스트 패널을 엽니다.
오른쪽 클릭
패널을 열지 않고 현재 컨텍스트를 메시지에 즉시 포함합니다. 현재 선택된 파일과 컨텍스트를 첨부하는 빠른 바로가기입니다.
프로젝트 이미지
개요
프로젝트 이미지 패널은 프로젝트와 관련된 모든 이미지를 위한 중앙 갤러리입니다. AI 대화에 첨부하거나 워크스페이스 내에서 정리하고 싶은 스크린샷, 목업, 참조 이미지, 시각적 자산을 업로드합니다.
기능
이미지 업로드
업로드 영역을 클릭하거나 패널에 직접 이미지를 드래그 앤 드롭합니다. Ctrl+V / Cmd+V를 사용하여 클립보드에서 이미지를 붙여넣을 수도 있습니다.
이미지 그리드
업로드된 이미지가 쉬운 탐색과 선택을 위해 썸네일 그리드로 표시됩니다.
선택 컨트롤
클릭하여 개별 이미지를 선택하거나, 모두 선택/모두 선택 해제를 사용하여 일괄 선택을 관리합니다. 선택된 이미지는 모두 삭제로 삭제할 수 있습니다.
메시지에 첨부
선택된 이미지를 AI 에이전트에 메시지를 보낼 때 시각적 컨텍스트로 포함하여 요청에 대한 참조 자료를 제공할 수 있습니다.
화면 녹화
개요
화면 녹화 패널을 통해 화면 녹화를 캡처하고 캡처 설정을 구성합니다. 녹화된 프레임은 이미지로 저장되어 AI 에이전트 대화에 첨부할 수 있어 요청에 시각적 컨텍스트를 제공합니다.
캡처 설정
Capture Speed
Slow (2 FPS)와 Normal (4 FPS) 중 선택합니다. 녹화가 너무 빠르거나 콘텐츠를 놓치는 경우 Slow를 사용합니다. Normal은 더 많은 세부 정보를 캡처하지만 더 많은 스토리지를 사용합니다.
이미지당 프레임
이미지당 결합되는 프레임 수를 제어합니다. 개별 스크린샷의 경우 1로 설정하거나, 단일 이미지에 여러 프레임을 보여주는 그리드 구성의 경우 더 높은 값으로 설정합니다.
그리드 열
여러 프레임을 단일 이미지로 결합할 때 그리드 레이아웃의 열 수를 설정합니다. 세로 스태킹의 경우 1을 사용하거나 넓은 그리드의 경우 더 높은 값을 사용합니다.
캡처 소스
캡처할 화면이나 모니터를 선택합니다. 해상도와 위치 세부 정보와 함께 사용 가능한 모니터를 표시합니다. 기본 모니터는 쉬운 식별을 위해 라벨이 지정됩니다.
녹화 탭
녹화 탭은 이전에 캡처된 모든 녹화를 표시합니다. 과거 세션을 탐색하고, 캡처된 프레임을 검토하며, 시각적 참조를 위해 새 AI 대화에 첨부합니다.
설정
개요
설정 패널은 활성 AI 에이전트에 대한 구성 옵션을 제공합니다. 채팅 입력 사이드바의 기어 아이콘에서 접근합니다. 설정은 권한 모드 및 기타 에이전트별 동작을 제어합니다.
권한 모드
모든 권한 건너뛰기
활성화되면 에이전트의 모든 권한 검사를 우회합니다 (--dangerously-skip-permissions와 동등). 에이전트가 확인 프롬프트 없이 파일 편집, 터미널 명령, 기타 작업을 실행할 수 있습니다.
재시작 필요
권한 설정 변경 사항은 다음 세션에 적용됩니다. 새 구성을 적용하려면 에이전트 탭을 닫고 다시 엽니다.
음성 입력
개요
음성 입력 버튼은 채팅 입력 사이드바 하단의 마이크 아이콘입니다. 플랫폼 네이티브 음성-텍스트 기능을 제공하여 타이핑 대신 AI 에이전트에 메시지를 받아쓸 수 있습니다.
작동 방식
활성화
마이크 아이콘을 클릭하여 음성 입력을 시작합니다. 청취 중에 아이콘이 활성 상태를 표시합니다.
받아쓰기
자연스럽게 말하면 시스템의 음성 인식(Windows의 Windows Speech, macOS의 받아쓰기)을 사용하여 채팅 입력 필드에 실시간으로 단어가 변환됩니다.
전송
받아쓰기가 완료되면 변환된 텍스트를 검토하고 보내기를 클릭하거나 Enter를 눌러 에이전트에 메시지를 제출합니다.
단축키
마우스 중간 버튼
Windows와 Mac에서 (마우스에 중간 버튼이 있는 경우) 마우스 중간 버튼을 눌러 녹음을 시작합니다. 채팅 입력 영역에서 다시 클릭하여 녹음을 중지하고 메시지를 자동으로 전송합니다.
커스텀 단축키
설정의 음성 탭에서 음성 입력을 위한 커스텀 키보드 단축키를 설정할 수 있습니다. 마우스를 사용하지 않고 음성 녹음을 시작하고 중지할 수 있습니다.