> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xkat.space/llms.txt
> Use this file to discover all available pages before exploring further.

# xkat-cli: Agent & Lab

> Hubungkan browser ke PC (Agent) atau lingkungan Ubuntu terisolasi untuk kuliah (Lab).

**xkat-cli** adalah paket CLI xkat. Satu perintah `xkat` menyediakan **dua alat** — jangan dicampur.

| Alat      | Perintah                      | Untuk                                     |
| :-------- | :---------------------------- | :---------------------------------------- |
| **Agent** | `xkat up` · `status` · `down` | Hubungkan workspace browser ke **PC ini** |
| **Lab**   | `xkat lab …`                  | **Ubuntu 24.04** terisolasi untuk kuliah  |

<CardGroup cols={2}>
  <Card title="Unduhan" icon="download" href="https://xkat.space/id/download">
    Desktop & CLI di [xkat.space/download](https://xkat.space/id/download)
  </Card>

  <Card title="Lihat di npm" icon="npm" href="https://www.npmjs.com/package/xkat-cli">
    xkat-cli di registri npm
  </Card>
</CardGroup>

***

## Instalasi

```bash theme={null}
npx xkat-cli@latest
npm install -g xkat-cli
```

Syarat: **Node.js 18+**. Lihat [lingkungan lokal](/id/learn/workspace/local-setup). Di app **Desktop**, menu **Tools**.

***

## 1) Agent

Dengan **Agent**, [Dynamic Workspace](/id/learn/workspace/overview) memakai mesin Anda.

### Fungsi

<CardGroup cols={2}>
  <Card title="Shell lokal" icon="terminal">
    Terminal web ↔ shell PC
  </Card>

  <Card title="Sinkron file" icon="arrows-rotate">
    Direktori kerja dengan web
  </Card>

  <Card title="Hanya localhost" icon="shield-check">
    <code>127.0.0.1:10022</code>
  </Card>

  <Card title="Latar belakang" icon="bolt">
    <code>xkat up</code>
  </Card>
</CardGroup>

### Perintah

```bash theme={null}
xkat up
xkat status
xkat down
```

```bash theme={null}
npx xkat-cli@latest up
```

### Keamanan

* Hanya localhost
* Hanya domain resmi
* `~/.xkat/agent.log`

***

## 2) Lab

**Ubuntu 24.04** untuk kuliah Linux, jaringan, dan agen. Tanpa setup VM manual.

### Perintah

```bash theme={null}
xkat lab install
xkat lab up
xkat lab shell
xkat lab stop
xkat lab delete
xkat lab status
xkat lab doctor
xkat lab reset
```

### Alur tipikal

1. `xkat lab install`
2. `xkat lab up`
3. `xkat lab shell`
4. `xkat lab stop` / `xkat lab delete`

### Agent vs Lab

| Cek   | Perintah          |
| :---- | :---------------- |
| Agent | `xkat status`     |
| Lab   | `xkat lab status` |

***

## Aplikasi desktop

Dari [Unduhan](https://xkat.space/id/download). Installer `…/desktop/v{version}/…`. Menu **Tools** untuk Agent/Lab. Login: browser sistem → `xkat://` → `https://xkat.space/api/auth/desktop/complete`.

***

## Hubungan dengan cloud

|             | Cloud                                        | Agent      | Lab                  |
| :---------- | :------------------------------------------- | :--------- | :------------------- |
| Setup       | [zero-setup](/id/learn/workspace/zero-setup) | `xkat up`  | `xkat lab install`   |
| Berjalan di | xkat cloud                                   | host OS    | Ubuntu VM            |
| Cocok untuk | quick start                                  | host tools | Linux / net / agents |

***

## Lainnya

* [Unduhan](https://xkat.space/id/download)
* [Lingkungan lokal](/id/learn/workspace/local-setup)
* [npm: xkat-cli](https://www.npmjs.com/package/xkat-cli)