> ## 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

> Browser mit dem PC verbinden (Agent) oder isolierte Ubuntu-Übungsumgebung (Lab).

**xkat-cli** ist das CLI-Paket von xkat. Ein Befehl `xkat` bietet **zwei Werkzeuge** — nicht verwechseln.

| Werkzeug  | Befehle                       | Zweck                                         |
| :-------- | :---------------------------- | :-------------------------------------------- |
| **Agent** | `xkat up` · `status` · `down` | Browser-Workspace mit **diesem PC** verbinden |
| **Lab**   | `xkat lab …`                  | Isoliertes **Ubuntu 24.04** für Kurse         |

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

  <Card title="Auf npm" icon="npm" href="https://www.npmjs.com/package/xkat-cli">
    xkat-cli im npm-Registry
  </Card>
</CardGroup>

***

## Installation

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

Voraussetzung: **Node.js 18+**. Siehe [lokale Umgebung](/de/learn/workspace/local-setup). Im **Desktop**-App-Menü **Tools** dieselben Befehle.

***

## 1) Agent

Mit dem **Agent** verbindet sich der [Dynamic Workspace](/de/learn/workspace/overview) mit Ihrem Rechner.

### Funktionen

<CardGroup cols={2}>
  <Card title="Lokale Shell" icon="terminal">
    Web-Terminal ↔ PC-Shell
  </Card>

  <Card title="Dateisync" icon="arrows-rotate">
    Arbeitsverzeichnis mit dem Web
  </Card>

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

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

### Befehle

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

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

### Sicherheit

* Nur localhost
* Nur offizielle Domains
* `~/.xkat/agent.log`

***

## 2) Lab

**Ubuntu 24.04** für Linux-, Netzwerk- und Agent-Kurse. Keine manuelle VM-Einrichtung.

### Befehle

```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
```

### Ablauf

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

### Agent vs Lab

| Prüfung | Befehle           |
| :------ | :---------------- |
| Agent   | `xkat status`     |
| Lab     | `xkat lab status` |

***

## Desktop-App

Von [Download](https://xkat.space/de/download). Installer unter `…/desktop/v{version}/…`. Menü **Tools** für Agent/Lab. Login: Systembrowser → `xkat://` → `https://xkat.space/api/auth/desktop/complete`.

***

## Bezug zur Cloud

|               | Cloud                                        | Agent      | Lab                  |
| :------------ | :------------------------------------------- | :--------- | :------------------- |
| Setup         | [zero-setup](/de/learn/workspace/zero-setup) | `xkat up`  | `xkat lab install`   |
| Läuft auf     | xkat cloud                                   | host OS    | Ubuntu VM            |
| Am besten für | quick start                                  | host tools | Linux / net / agents |

***

## Mehr

* [Download](https://xkat.space/de/download)
* [Lokale Umgebung](/de/learn/workspace/local-setup)
* [npm: xkat-cli](https://www.npmjs.com/package/xkat-cli)