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

# Tham chiếu CLI

> Toàn bộ lệnh và tùy chọn của CLI nagare.

```bash theme={null}
nagare [lệnh] [tùy chọn]
```

| Lệnh | Mô tả |
| - | - |
| [`nagare gateway start`](#nagare-gateway-start) | Khởi động gateway. |
| [`nagare gateway stop`](#nagare-gateway-stop) | Dừng gateway. |
| [`nagare web`](#nagare-web) | Phục vụ và mở giao diện web. |
| [`nagare auth token`](#nagare-auth-token) | Tạo token đăng nhập. |
| [`nagare doctor`](#nagare-doctor) | Kiểm tra tình trạng cài đặt. |
| [`nagare plugin build`](#nagare-plugin-build) | Build và đóng gói plugin. |

## Tùy chọn chung

| Tùy chọn | Mô tả |
| - | - |
| `-v`, `--version` | In phiên bản. |
| `-h`, `--help` | Xem trợ giúp của lệnh. |

## nagare gateway start

Khởi động `nagare-gateway` ở tiền cảnh của terminal hiện tại. PID được lưu vào `~/.nagare/.gateway.pid`.

```bash theme={null}
nagare gateway start [--host <host>]
```

| Tùy chọn | Mô tả |
| - | - |
| `--host <host>` | Địa chỉ gateway lắng nghe. Mặc định `localhost`. |
| `-d`, `--debug` | Chế độ debug, dành cho phát triển Nagare từ mã nguồn. |

Lần chạy đầu tiên tạo cặp khóa RSA trong keyring hệ thống (dịch vụ `nagare.security.keyring`). Gateway dùng khóa công khai để xác minh token.

> [!WARNING]
>
> Nếu đặt `--host 0.0.0.0`, gateway có thể được truy cập từ máy khác trong mạng. Mọi API vẫn yêu cầu token, nhưng hãy cân nhắc kỹ vì Nagare có thể điều khiển máy của bạn.

## nagare gateway stop

Gửi yêu cầu tắt tới gateway đang chạy.

```bash theme={null}
nagare gateway stop
```

In `Nagare gateway shutdown requested.` khi thành công, hoặc `Nagare gateway is not running.` nếu gateway không chạy.

## nagare web

Phục vụ giao diện web nhúng sẵn và mở trình duyệt với đăng nhập tự động.

```bash theme={null}
nagare web [--addr <addr>] [--gateway <url>] [--token <token>] [--no-open]
```

| Tùy chọn | Mặc định | Mô tả |
| - | - | - |
| `--addr` | `127.0.0.1:3005` | Địa chỉ HTTP của giao diện web. Có thể đổi cổng bằng biến `NAGARE_WEB_UI_PORT`. |
| `--gateway` | `http://localhost:9832` | URL gateway dùng để đăng nhập tự động. Lấy từ `NAGARE_GATEWAY_URL` hoặc `NAGARE_GATEWAY_PORT` nếu có. |
| `--token` | Tự tạo | Token dùng để đăng nhập tự động. |
| `--no-open` | `false` | Không mở trình duyệt, chỉ in URL đăng nhập. |

## nagare auth token

Tạo token JWT để đăng nhập giao diện web, ứng dụng desktop hoặc gọi API.

```bash theme={null}
nagare auth token
# Your token is: eyJhbGciOi...
```

Token được ký bằng khóa RSA trong keyring và có hiệu lực 60 giờ.

## nagare doctor

Kiểm tra các thành phần của Nagare:

| Mục kiểm tra | Nội dung |
| - | - |
| Gateway process | Có tệp PID và tiến trình còn sống. |
| Gateway HTTP reachable | Truy cập được `http://localhost:<port>/ws`. |
| Plugin IPC socket | Socket/pipe plugin tồn tại và kết nối được. |
| SQLite database | `~/.nagare/databases/nagare.db` hợp lệ. |
| RSA keyring | Đọc được cặp khóa RSA trong keyring. |
| Module: nagare\_vector | Module có trong `~/.nagare/modules`. |

```bash theme={null}
nagare doctor
```

Lệnh thoát với mã `1` nếu có mục thất bại.

## nagare plugin build

Build và đóng gói plugin trong thư mục hiện tại. Xem [Tổng quan plugin](https://docs.nagare.smtdfc.net/plugins/overview.md#build-goi-plugin).

```bash theme={null}
nagare plugin build [--sign <private-key.pem>]
```

| Tùy chọn | Mô tả |
| - | - |
| `-s`, `--sign <path>` | Ký gói bằng khóa riêng Ed25519 (PEM). Xem [Ký số plugin](https://docs.nagare.smtdfc.net/plugins/signing.md). |

## nagare-desktop

Ứng dụng desktop là một tệp thực thi riêng, không phải lệnh con của `nagare`. Xem [Cài đặt](https://docs.nagare.smtdfc.net/installation.md#ung-dung-desktop).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.