# @ai-kod/cli

AI-KOD CLI — API-first инструмент поверх Orchestrator V7. Вся логика команд теперь реализована через yargs CommandModule, а справка/примеры берутся из одного источника (`apps/cli/src/yargs/definitions.ts`).

## Быстрый старт

```bash
pnpm ai-kod --help            # корневая справка + список команд
pnpm ai-kod run --help        # детальная помощь по конкретной команде
pnpm ai-kod workers list --json
```

Глобальные флаги (`--json`, `--jsonl`, `--verbosity`) задаются один раз — bootstrap автоматически прокидывает их во все подкоманды.

## Структура

| Путь | Назначение |
| --- | --- |
| `src/yargs/definitions.ts` | Описание команд/примеров, используется рендерером help и unit-тестами |
| `src/yargs/commands/*.ts` | CommandModule для каждой команды (`run`, `task`, `workers`, `library`, `clean`, …) |
| `src/commands/*.ts` | Исполнители, которые говорят с API/Registry |
| `tests/unit/cli/yargs/examples.test.ts` | Проверяет, что все примеры из справки разбираются yargs без ошибок |

## Разработка

```bash
pnpm --filter "@ai-kod/cli" lint
pnpm --filter "@ai-kod/cli" typecheck
pnpm vitest --run tests/unit/cli/yargs/examples.test.ts
```

Smoke-проверки help:

```bash
pnpm ai-kod --help
pnpm ai-kod run --help
pnpm ai-kod workers --help
pnpm ai-kod clean --help
```