무엇을 하나
로컬 셸 브리지
웹 IDE 터미널을 내 컴퓨터의 네이티브 셸(PTY)에 직접 연결합니다. 내 사용자 권한으로
동작합니다.
실시간 파일 동기화
로컬 작업 디렉터리의 변경을 감시하고 웹 대시보드와 즉시 동기화합니다.
무설치 실행
npx로 필요할 때 바로 실행 — 별도 설치가 필요 없습니다.보안 우선
127.0.0.1에만 바인딩하고 요청 출처를 검증해, 로컬 제어를 안전하게
유지합니다.퀵스타트
설치 없이 npx로 바로 실행:up은 에이전트를 백그라운드로 시작하고 즉시 반환하므로, 터미널이 계속 자유롭습니다.
전역 설치 (선택)
자주 쓴다면 한 번 설치해 두세요:npm에서 보기
npm 레지스트리의 xkat-cli
요구 사항
- Node.js 16 이상.
보안
에이전트는 로컬 제어를 안전하게 지키도록 설계되었습니다:- 로컬호스트 전용 — 포트는 내 컴퓨터에서만 접근 가능합니다.
- 출처 검증 — 공식 xKat 도메인에서 온 연결만 허용합니다.
- 감사 로그 — 모든 연결 시도와 파일 변경 이벤트를 로컬에 기록합니다
(
~/.xkat/agent.log).
클라우드 워크스페이스와의 관계
| 클라우드 워크스페이스 | 로컬 머신 (CLI) | |
|---|---|---|
| 설정 | 무설치 | npx xkat up |
| 실행 위치 | xKat 클라우드 서버 | 내 컴퓨터 |
| 적합한 경우 | 빠른 시작, 모든 기기 | 내 도구·파일·환경 사용 |