Skip to main content
xkat-cli는 xkat 명령줄 패키지입니다. 명령 xkat 하나에 도구 두 가지가 들어 있습니다. 서로 섞지 마세요.

다운로드 페이지

데스크톱 앱과 xkat-cli 설치 — xkat.space/download

npm에서 보기

npm 레지스트리의 xkat-cli

​
설치

최신 버전 유지. xkat-cli는 하루에 한 번 npm에 새 버전이 있는지 확인하고 한 줄로 알려 줍니다 — 스스로 업데이트하지는 않습니다. npm install -g xkat-cli@latest로 올리거나 npx xkat-cli@latest up을 쓰면 됩니다. 알림을 끄려면 환경 변수 XKAT_NO_UPDATE_CHECK=1을 설정하세요.
요구 사항: Node.js 18+ (전역 설치 시). OS별 호스트 준비는 로컬 환경 설정을 참고하세요. xkat 데스크톱 앱의 Tools 메뉴에서도 같은 명령을 실행할 수 있습니다 (로컬/모노레포 에이전트 바이너리). Lab은 한 번 xkat-cli lab install(또는 Tools → Lab: Install)로 준비해야 합니다.

​
1) Agent — 로컬 브릿지

기본적으로 다이나믹 워크스페이스는 클라우드에서도 동작할 수 있습니다. Agent를 쓰면 브라우저가 내 PC에 연결되어 로컬 셸·도구· 파일 실시간 동기화를 씁니다.

​
무엇을 하나

로컬 셸 브릿지

웹 IDE 터미널 ↔ 이 PC 네이티브 셸(PTY), 내 사용자 권한.

실시간 파일 동기화

작업 디렉터리 변경을 웹 대시보드와 즉시 동기화.

localhost 전용

127.0.0.1:38000–38050에만 바인딩하고 요청 출처를 검증.

백그라운드 실행

xkat-cli up으로 시작하고 터미널은 바로 비워 둡니다.

​
명령

전역 설치 없이:

​
퀵스타트

1

에이전트 시작

2

워크스페이스 열기

브라우저에서 내 컴퓨터 / 로컬 브릿지를 쓰는 강의를 실행합니다.
3

끝나면 중지

​
보안

  • 로컬호스트 전용 — 네트워크에 포트를 열지 않습니다.
  • 출처 검증 — 공식 xkat 도메인만 연결 가능.
  • 감사 로그 — ~/.xkat/agent.log
적합한 경우: 호스트의 CLI 도구(bash, vercel-cli 등), 내 파일·환경 그대로 사용.
  • WSL(Ubuntu)이 아닌 Windows 호스트 터미널에서 실행: 에이전트는 호스트 브라우저와 통신하므로 Windows PowerShell 또는 CMD 창에서 실행해야 합니다.
  • PermissionDenied (10013) 에러 발생 시: Hyper-V / WSL2 서비스(winnat)가 38000–38050 포트를 차단 범위로 점유한 경우입니다. 관리자 권한 PowerShell에서 net stop winnat 후 net start winnat를 실행하여 포트를 해제하세요.

​
2) Lab — Ubuntu 실습 환경

리눅스·네트워크·Hermes 같은 에이전트 강의는 호스트에 직접 돌리기 부담될 수 있습니다. Lab은 학습자마다 같은 Ubuntu 24.04 환경을 주며, Podman 컨테이너로 돕니다. Podman·VirtualBox·Hyper-V를 직접 설정하지 않습니다 — xkat-cli lab install이 대신하고, 그 뒤로는 xkat-cli lab 명령만 씁니다. 운영체제를 설치하는 강의(우분투·페도라·openSUSE…)는 그 컨테이너 안에서 진짜 가상 머신을 돌립니다. 그래서 설치 마법사를 내 컴퓨터에서처럼 눈으로 봅니다.

​
무엇을 하나

격리된 Ubuntu

Ubuntu 24.04 LTS 클라우드 이미지 — Windows·macOS·Linux에서 동일.

한 번 준비

xkat-cli lab install로 Lab 도구 설치 (관리자 권한 요청 가능).

단순한 수명 주기

up · shell · stop · delete — 하이퍼바이저 UI를 배울 필요 없음.

깔끔한 종료

xkat-cli lab delete는 컨테이너만 지우고 작업물은 남깁니다. 디스크까지 비우려면 xkat-cli lab purge를 씁니다.

​
명령

​
전형적인 강의 흐름

1

한 번 준비

관리자 프롬프트가 나오면 수락합니다. VM을 손으로 설정하지 않습니다.
2

Lab 시작

첫 실행은 Ubuntu 다운로드가 있을 수 있으며, 진행 상황이 터미널에 표시됩니다.
3

강의 따라하기

4

끝나면

​
Agent vs Lab (혼동 주의)

​
데스크톱 앱

다운로드에서 설치합니다. 설치 파일은 …/desktop/v{버전}/… 처럼 표시 버전과 같은 경로로 제공됩니다. 앱에는 xkat-cli 가 들어 있어 앱에서 쓰려고 npm install 할 필요가 없습니다. 타이틀바 Tools 메뉴는 그 사본으로 Agent / Lab 명령을 실행합니다. Lab: Open Shell 은 시스템 터미널을 엽니다. 더 새로운 앱은 더 새로운 xkat-cli 를 함께 가져오고, npm 으로 따로 설치한 사본은 따로 업데이트합니다. 데스크톱 로그인은 시스템 브라우저에서 진행하고, 끝나면 앱이 자동으로 로그인됩니다 (127.0.0.1 루프백 · 인가 코드 + PKCE). 앱으로 돌아오려고 따로 할 일은 없습니다.

​
클라우드 워크스페이스와의 관계

브라우저 다이나믹 워크스페이스 경험은 같고, 코드가 어디서 도는지만 달라집니다.

​
더 보기