메인 콘텐츠로 건너뛰기
기본적으로 다이나믹 워크스페이스는 xKat 클라우드 서버에서 동작합니다. xKat CLI(xKat Agent)를 쓰면 브라우저 워크스페이스를 내 컴퓨터에 연결해, 로컬 셸에서 강의를 실행하고 파일을 실시간 동기화할 수 있습니다.

무엇을 하나

로컬 셸 브리지

웹 IDE 터미널을 내 컴퓨터의 네이티브 셸(PTY)에 직접 연결합니다. 내 사용자 권한으로 동작합니다.

실시간 파일 동기화

로컬 작업 디렉터리의 변경을 감시하고 웹 대시보드와 즉시 동기화합니다.

무설치 실행

npx로 필요할 때 바로 실행 — 별도 설치가 필요 없습니다.

보안 우선

127.0.0.1에만 바인딩하고 요청 출처를 검증해, 로컬 제어를 안전하게 유지합니다.

퀵스타트

설치 없이 npx로 바로 실행:
npx xkat up
up은 에이전트를 백그라운드로 시작하고 즉시 반환하므로, 터미널이 계속 자유롭습니다.
1

에이전트 시작

npx xkat up        # 백그라운드 시작 (별칭: start)
2

워크스페이스 열기

브라우저로 돌아오면, 워크스페이스가 이제 내 로컬 셸과 파일을 사용할 수 있습니다.
3

언제든 관리

xkat status        # 에이전트 실행 중인지 확인
xkat down          # 백그라운드 에이전트 중지 (별칭: stop)

전역 설치 (선택)

자주 쓴다면 한 번 설치해 두세요:
npm install -g xkat-cli
xkat up

npm에서 보기

npm 레지스트리의 xkat-cli

요구 사항

  • Node.js 16 이상.

보안

에이전트는 로컬 제어를 안전하게 지키도록 설계되었습니다:
  • 로컬호스트 전용 — 포트는 내 컴퓨터에서만 접근 가능합니다.
  • 출처 검증 — 공식 xKat 도메인에서 온 연결만 허용합니다.
  • 감사 로그 — 모든 연결 시도와 파일 변경 이벤트를 로컬에 기록합니다 (~/.xkat/agent.log).

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

클라우드 워크스페이스로컬 머신 (CLI)
설정무설치npx xkat up
실행 위치xKat 클라우드 서버내 컴퓨터
적합한 경우빠른 시작, 모든 기기내 도구·파일·환경 사용
둘 다 브라우저에서 동일한 다이나믹 워크스페이스 경험을 사용합니다.