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

> Conecta el navegador a tu PC (Agent) o usa un Ubuntu aislado para prácticas (Lab).

**xkat-cli** es el paquete CLI de xkat. Un comando `xkat` ofrece **dos herramientas** — no las mezcles.

| Herramienta | Comandos                      | Para qué                                          |
| :---------- | :---------------------------- | :------------------------------------------------ |
| **Agent**   | `xkat up` · `status` · `down` | Conectar el workspace del navegador a **este PC** |
| **Lab**     | `xkat lab …`                  | **Ubuntu 24.04** aislado para clases              |

<CardGroup cols={2}>
  <Card title="Descargas" icon="download" href="https://xkat.space/es/download">
    Escritorio y CLI en [xkat.space/download](https://xkat.space/es/download)
  </Card>

  <Card title="Ver en npm" icon="npm" href="https://www.npmjs.com/package/xkat-cli">
    xkat-cli en el registro npm
  </Card>
</CardGroup>

***

## Instalación

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

Requisito: **Node.js 18+**. Ver [entorno local](/es/learn/workspace/local-setup). En la app **Desktop**, menú **Tools**.

***

## 1) Agent

Con el **Agent**, el [Dynamic Workspace](/es/learn/workspace/overview) usa tu máquina.

### Qué hace

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

  <Card title="Sincronización" icon="arrows-rotate">
    Directorio de trabajo con la web
  </Card>

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

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

### Comandos

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

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

### Seguridad

* Solo localhost
* Solo dominios oficiales
* `~/.xkat/agent.log`

***

## 2) Lab

**Ubuntu 24.04** para cursos de Linux, red y agentes. Sin configurar la VM a mano.

### Comandos

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

### Flujo típico

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

### Agent vs Lab

| Comprobar | Comandos          |
| :-------- | :---------------- |
| Agent     | `xkat status`     |
| Lab       | `xkat lab status` |

***

## App de escritorio

Desde [Descargas](https://xkat.space/es/download). Instaladores en `…/desktop/v{version}/…`. Menú **Tools** para Agent/Lab. Login: navegador del sistema → `xkat://` → `https://xkat.space/api/auth/desktop/complete`.

***

## Relación con la nube

|               | Cloud                                        | Agent      | Lab                  |
| :------------ | :------------------------------------------- | :--------- | :------------------- |
| Configuración | [zero-setup](/es/learn/workspace/zero-setup) | `xkat up`  | `xkat lab install`   |
| Se ejecuta en | xkat cloud                                   | host OS    | Ubuntu VM            |
| Mejor para    | quick start                                  | host tools | Linux / net / agents |

***

## Más

* [Descargas](https://xkat.space/es/download)
* [Entorno local](/es/learn/workspace/local-setup)
* [npm: xkat-cli](https://www.npmjs.com/package/xkat-cli)