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

> Relier le navigateur au PC (Agent) ou utiliser un Ubuntu isolé pour les cours (Lab).

**xkat-cli** est le paquet CLI d’xkat. Une commande `xkat` offre **deux outils** — ne les confondez pas.

| Outil     | Commandes                     | Usage                                            |
| :-------- | :---------------------------- | :----------------------------------------------- |
| **Agent** | `xkat up` · `status` · `down` | Connecter le workspace du navigateur à **ce PC** |
| **Lab**   | `xkat lab …`                  | **Ubuntu 24.04** isolé pour les cours            |

<CardGroup cols={2}>
  <Card title="Téléchargements" icon="download" href="https://xkat.space/fr/download">
    Desktop et CLI sur [xkat.space/download](https://xkat.space/fr/download)
  </Card>

  <Card title="Voir sur npm" icon="npm" href="https://www.npmjs.com/package/xkat-cli">
    xkat-cli sur le registre npm
  </Card>
</CardGroup>

***

## Installation

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

Prérequis : **Node.js 18+**. Voir [environnement local](/fr/learn/workspace/local-setup). Dans l’app **Desktop**, menu **Tools**.

***

## 1) Agent

Avec l’**Agent**, le [Dynamic Workspace](/fr/learn/workspace/overview) utilise votre machine.

### Fonctions

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

  <Card title="Sync fichiers" icon="arrows-rotate">
    Répertoire de travail avec le web
  </Card>

  <Card title="Localhost seul" icon="shield-check">
    <code>127.0.0.1:10022</code>
  </Card>

  <Card title="Arrière-plan" icon="bolt">
    <code>xkat up</code>
  </Card>
</CardGroup>

### Commandes

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

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

### Sécurité

* Localhost uniquement
* Domaines officiels uniquement
* `~/.xkat/agent.log`

***

## 2) Lab

**Ubuntu 24.04** pour les cours Linux, réseau et agents. Pas de VM manuelle.

### Commandes

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

### Déroulement

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

### Agent vs Lab

| Vérifier | Commandes         |
| :------- | :---------------- |
| Agent    | `xkat status`     |
| Lab      | `xkat lab status` |

***

## Application bureau

Depuis [Téléchargements](https://xkat.space/fr/download). Installateurs `…/desktop/v{version}/…`. Menu **Tools** pour Agent/Lab. Connexion : navigateur système → `xkat://` → `https://xkat.space/api/auth/desktop/complete`.

***

## Lien avec le cloud

|               | Cloud                                        | Agent      | Lab                  |
| :------------ | :------------------------------------------- | :--------- | :------------------- |
| Configuration | [zero-setup](/fr/learn/workspace/zero-setup) | `xkat up`  | `xkat lab install`   |
| S’exécute sur | xkat cloud                                   | host OS    | Ubuntu VM            |
| Idéal pour    | quick start                                  | host tools | Linux / net / agents |

***

## Plus

* [Téléchargements](https://xkat.space/fr/download)
* [Environnement local](/fr/learn/workspace/local-setup)
* [npm: xkat-cli](https://www.npmjs.com/package/xkat-cli)