# Команды CLI

Краткий справочник. Подробности — в разделе [CLI](/catalib/cli/overview.md).

## `catalib build`

```
catalib build [--project DIR] [--check]
```

| Опция             | По умолчанию | Назначение                            |
| ----------------- | ------------ | ------------------------------------- |
| `--project`, `-p` | `.`          | каталог проекта                       |
| `--check`         | выкл.        | не записывать файлы, только проверить |

Создаёт `<out>/<plugin_id>.py` и `<out>/<plugin_id>.plugin`.

## `catalib watch`

```
catalib watch [--project DIR] [--deploy] [--serial SERIAL] [--port PORT]
```

| Опция             | По умолчанию | Назначение                        |
| ----------------- | ------------ | --------------------------------- |
| `--project`, `-p` | `.`          | каталог проекта                   |
| `--deploy`        | выкл.        | деплой на устройство после сборки |
| `--serial`        | —            | серийный номер устройства         |
| `--port`          | `42690`      | локальный порт `adb forward`      |

## `catalib init`

```
catalib init NAME [--id ID] [--dir DIR] [--author AUTHOR] [--template T]
```

| Аргумент/опция     | По умолчанию | Назначение                                                                       |
| ------------------ | ------------ | -------------------------------------------------------------------------------- |
| `NAME`             | обязателен   | отображаемое имя                                                                 |
| `--id`             | из `NAME`    | идентификатор плагина                                                            |
| `--dir`, `-d`      | `= ID`       | каталог проекта                                                                  |
| `--author`         | пусто        | автор                                                                            |
| `--template`, `-t` | `hook`       | шаблон: `hook`, `menu`, `minimal`, `settings` (см. [init](/catalib/cli/init.md)) |

## `catalib doctor`

```
catalib doctor [--project DIR] [--serial SERIAL] [--port PORT]
```

| Опция             | По умолчанию | Назначение                   |
| ----------------- | ------------ | ---------------------------- |
| `--project`, `-p` | `.`          | каталог проекта              |
| `--serial`        | —            | серийный номер устройства    |
| `--port`          | `42690`      | локальный порт `adb forward` |

Проверяет Python (≥ 3.11), `adb`, устройство, dev server и `catalib.toml`. Код возврата `1` только при `fail` (старый Python, битый манифест); отсутствие устройства/dev server — `warn`. Подробнее — [catalib doctor](/catalib/cli/doctor.md).

## `catalib logs`

```
catalib logs [--project DIR] [--serial S] [--lines N] [--clear] [--all] [--filter TEXT]
```

| Опция             | По умолчанию | Назначение                             |
| ----------------- | ------------ | -------------------------------------- |
| `--project`, `-p` | `.`          | каталог проекта (источник `plugin_id`) |
| `--serial`        | —            | серийный номер устройства              |
| `--lines`, `-n`   | `100`        | сколько последних строк logcat         |
| `--clear`         | выкл.        | очистить буфер логов перед чтением     |
| `--all`           | выкл.        | весь logcat, без фильтра               |
| `--filter`        | `plugin_id`  | своя подстрока фильтра                 |

`adb logcat`, отфильтрованный по плагину (как MCP `adb_get_logs`). Код возврата `1` — ошибка `adb`. Подробнее — [catalib logs](/catalib/cli/logs.md).

## `catalib stubs`

```
catalib stubs [--dir DIR] [--force]
```

| Опция         | По умолчанию | Назначение                      |
| ------------- | ------------ | ------------------------------- |
| `--dir`, `-d` | `typings`    | каталог для `.pyi`-стабов SDK   |
| `--force`     | выкл.        | перезаписать существующие стабы |

Подробнее — [Типизация и автодополнение](/catalib/rukovodstvo/typing.md).

## `catalib version`

Печатает версию catalib.

## Коды возврата

| Код | Значение                  |
| --- | ------------------------- |
| `0` | успех                     |
| `1` | ошибка сборки/init/деплоя |
| `2` | ошибка разбора аргументов |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://raito-kyokai.gitbook.io/catalib/spravochnik/cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.