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

> ブラウザを PC に接続（Agent）、または講義用の隔離 Ubuntu 実習環境（Lab）。

**xkat-cli** は xkat の CLI です。`xkat` 一つに **2 つのツール**があります。混同しないでください。

| ツール       | コマンド                          | 用途                             |
| :-------- | :---------------------------- | :----------------------------- |
| **Agent** | `xkat up` · `status` · `down` | ブラウザ Workspace を **この PC** に接続 |
| **Lab**   | `xkat lab …`                  | 講義用 **Ubuntu 24.04** 隔離環境      |

<CardGroup cols={2}>
  <Card title="ダウンロード" icon="download" href="https://xkat.space/ja/download">
    [xkat.space/download](https://xkat.space/ja/download) でデスクトップと CLI を入手
  </Card>

  <Card title="npm で見る" icon="npm" href="https://www.npmjs.com/package/xkat-cli">
    npm レジストリの xkat-cli
  </Card>
</CardGroup>

***

## インストール

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

要件: **Node.js 18+**。[ローカル環境](/ja/learn/workspace/local-setup)も参照。**デスクトップ**の **Tools** メニューからも同じコマンドを実行できます。

***

## 1) Agent

[Dynamic Workspace](/ja/learn/workspace/overview) を自分のマシンに接続します。

### できること

<CardGroup cols={2}>
  <Card title="ローカルシェル" icon="terminal">
    Web IDE 端末 ↔ この PC のシェル
  </Card>

  <Card title="ファイル同期" icon="arrows-rotate">
    作業ディレクトリを Web と同期
  </Card>

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

  <Card title="バックグラウンド" icon="bolt">
    <code>xkat up</code>
  </Card>
</CardGroup>

### コマンド

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

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

### セキュリティ

* ローカルホストのみ
* 公式ドメインのみ接続可
* `~/.xkat/agent.log`

***

## 2) Lab

Linux・ネットワーク・エージェント講義向けの **Ubuntu 24.04**。VM を自分で設定する必要はありません。

### コマンド

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

### 典型的な流れ

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

### Agent vs Lab

| 確認    | コマンド              |
| :---- | :---------------- |
| Agent | `xkat status`     |
| Lab   | `xkat lab status` |

***

## デスクトップアプリ

[ダウンロード](https://xkat.space/ja/download)から。インストーラは `…/desktop/v{version}/…` 形式。タイトルバー **Tools** で Agent/Lab を実行。ログインはシステムブラウザ → `xkat://` → `https://xkat.space/api/auth/desktop/complete`。

***

## クラウド Workspace との関係

|         | Cloud                                        | Agent      | Lab                  |
| :------ | :------------------------------------------- | :--------- | :------------------- |
| セットアップ  | [zero-setup](/ja/learn/workspace/zero-setup) | `xkat up`  | `xkat lab install`   |
| 実行場所    | xkat cloud                                   | host OS    | Ubuntu VM            |
| 向いている用途 | quick start                                  | host tools | Linux / net / agents |

***

## 関連

* [ダウンロード](https://xkat.space/ja/download)
* [ローカル環境](/ja/learn/workspace/local-setup)
* [npm: xkat-cli](https://www.npmjs.com/package/xkat-cli)