xkat 하나에 도구 두 가지가
들어 있습니다. 서로 섞지 마세요.
다운로드 페이지
데스크톱 앱과 xkat-cli 설치 — xkat.space/download
npm에서 보기
npm 레지스트리의 xkat-cli
설치
xkat lab install(또는
Tools → Lab: Install)로 준비해야 합니다.
1) Agent — 로컬 브릿지
기본적으로 다이나믹 워크스페이스는 클라우드에서도 동작할 수 있습니다. Agent를 쓰면 브라우저가 내 PC에 연결되어 로컬 셸·도구· 파일 실시간 동기화를 씁니다.무엇을 하나
로컬 셸 브릿지
웹 IDE 터미널 ↔ 이 PC 네이티브 셸(PTY), 내 사용자 권한.
실시간 파일 동기화
작업 디렉터리 변경을 웹 대시보드와 즉시 동기화.
localhost 전용
127.0.0.1:10022에만 바인딩하고 요청 출처를 검증.백그라운드 실행
xkat up으로 시작하고 터미널은 바로 비워 둡니다.명령
퀵스타트
1
에이전트 시작
2
워크스페이스 열기
브라우저에서 내 컴퓨터 / 로컬 브릿지를 쓰는 강의를 실행합니다.
3
끝나면 중지
보안
- 로컬호스트 전용 — 네트워크에 포트를 열지 않습니다.
- 출처 검증 — 공식 xkat 도메인만 연결 가능.
- 감사 로그 —
~/.xkat/agent.log
2) Lab — Ubuntu 실습 환경
리눅스·네트워크·Hermes 같은 에이전트 강의는 호스트에 직접 돌리기 부담될 수 있습니다. Lab은 학습자마다 같은 Ubuntu 24.04를 줍니다. VirtualBox / Hyper-V를 직접 설정할 필요 없이xkat lab 명령만 쓰면 됩니다.
무엇을 하나
격리된 Ubuntu
Ubuntu 24.04 LTS 클라우드 이미지 — Windows·macOS·Linux에서 동일.
한 번 준비
xkat lab install로 Lab 도구 설치 (관리자 권한 요청 가능).단순한 수명 주기
up · shell · stop · delete — 하이퍼바이저 UI를 배울 필요 없음.
깔끔한 종료
xkat lab delete로 실습 환경을 지우고 디스크를 비웁니다.명령
전형적인 강의 흐름
1
한 번 준비
2
Lab 시작
3
강의 따라하기
4
끝나면
Agent vs Lab (혼동 주의)
데스크톱 앱
다운로드에서 설치합니다. 설치 파일은…/desktop/v{버전}/… 처럼 표시 버전과 같은 경로로 제공됩니다.
타이틀바 Tools 메뉴에서 Agent / Lab 명령을 실행할 수 있습니다.
Lab: Open Shell 은 시스템 터미널을 엽니다.
데스크톱 로그인은 시스템 브라우저 → auth-bridge → xkat:// 딥링크 후
앱이 https://xkat.space/api/auth/desktop/complete 로 이동합니다 (localhost 아님).
클라우드 워크스페이스와의 관계
브라우저 다이나믹 워크스페이스 경험은 같고,
코드가 어디서 도는지만 달라집니다.