@ai-kod/cli

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

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

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 без ошибок |

Разработка

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

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

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