Что доступно из командной строки
Список команд: localai --help или codesearch --help. Синтаксис отдельной команды:
localai repo status --help или codesearch help search.
help, --help или -h перед словами команды, а также --help или -h в любом месте после
них выводят справку в stdout и завершаются успешно; лишние или неизвестные слова после
ведущего help отклоняются. localai prune и localai update также понимают /? как запрос
своего синтаксиса и печатают его в stderr с кодом выхода 2. Язык справки определяется сохранённым выбором или LOCALAI_LANGUAGE (en / ru).
Контракты JSON сохранены: --json запрашивает машинный ответ вместо текстовой справки.
Набор не совпадает с MCP: часть инструментов существует только здесь, часть — только там.
| Команда | Что делает |
|---|---|
codesearch search --query "…" |
тот же поиск по смыслу и имени |
codesearch get-chunk --id … |
забрать фрагмент целиком |
codesearch status |
где лежит индекс, отстал ли, подключён ли репозиторий |
codesearch scan |
что вообще попадёт в индекс |
codesearch index / overlay |
собрать индекс вручную, вне управления Local AI |
codesearch evaluate --cases … |
прогнать корпус оценки качества поиска |
localai semantic definition / references / implementations / relationships |
навигация по объявлениям |
localai semantic impact --path src/Type.cs --line 12 --json |
прямые ссылки и входящие связи C# из индекса |
localai ask "…" <file> … |
механическая работа по файлам |
localai triage <log> |
разобрать лог |
localai read-image "…" <file> |
прочитать изображения или один PDF |
localai documents index / search |
собрать индекс OCR для PDF или найти фразу со ссылкой на источник |
localai translate --in <file> --from … --to … |
перевести |
localai sync |
собрать или обновить индекс |
localai hooks install |
поставить хуки, чтобы индекс обновлялся сам |
localai repo status |
подключён ли репозиторий |
localai doctor |
что не так с установкой, только чтение |
localai diagnostics |
просмотреть записанные диагностические данные или сохранить их в ZIP |
localai hardware plan |
оценить модели и контекст по подписанным данным релиза и этому компьютеру |
localai model status / pull / preflight |
модели: список установленных, загрузка, предварительная проверка |
localai policy show / set |
политика размещения модели в памяти |
localai prune |
убрать устаревшие поколения и overlay, архив очереди, старую телеметрию, записи брошенных репозиториев и старые версии |
localai telemetry |
сводка по локальным заданиям |
localai update |
обновить установку |
localai sync --root <worktree> подготавливает только указанную рабочую копию, в том
числе при изменении общей базы. Для обслуживания всех связанных копий явно укажите
--all-worktrees; указанная копия будет первой. --base-only не строит overlay.
SYNC_BASE сообщает о повторном использовании базы; SYNC_PLAN показывает явную область,
число рабочих копий и их порядок, а WORKTREE_PLAN — переиспользуемые и пересобираемые overlay.
ACTIVE_READY показывает, когда указанная копия может читать новое поколение, отдельно
от итоговой длительности синхронизации. Остальные копии читают прежнее поколение до
готовности своих overlay. С --all-worktrees обслуживание продолжается в том же процессе;
не запускайте вторую синхронизацию одновременно. Перед запуском проверяется верхняя
оценка общего объёма работы: база и все выбранные проходы рабочих копий. Прерванный
запуск сохраняет готовые копии доступными и допускает повторный запуск. Таймаут ожидания
MCP оставляет состояние выполнения неизвестным: следите через localai repo status --follow.
codesearch evaluate --cases … перед поиском сопоставляет эталонные имена C# с их
объявлениями в исходниках. Части [1/6] и [2/6] относятся к одному эталону. Необязательные
поля signature и namespace уточняют неоднозначные имена; если сигнатура всё ещё подходит
к нескольким объявлениям, оценщик отклоняет такой эталон. Для эталона только с путём
по-прежнему подходит любой результат из указанного файла. Меняется подсчёт метрик оценки;
ранжирование поиска и калиброванный порог остаются прежними.
Корпус оценки может содержать необязательный список excludedPaths: пути к файлам
относительно корня репозитория и префиксы каталогов, заканчивающиеся на /. Это буквальные
пути без glob-шаблонов; оба вида разделителей принимаются. Если файл --cases находится
внутри репозитория, он исключается автоматически; остальные эталонные материалы нужно
перечислить явно. Исключения применяются до векторного и лексического ранжирования.
Обычный поиск по-прежнему включает тесты.
Пути исключения не должны выходить за пределы репозитория или охватывать объявленный эталонный результат. Отчёт сохраняет коммит и дерево исходников, хеш незакоммиченного содержимого отдельно от коммита и дерева индекса, а также поколение и модель индекса, SHA-256 корпуса, уточнённые аннотации, параметры поиска и фактические исключения. Изменение снимка исходников, поколения индекса или аннотаций во время оценки прерывает запуск. Для воспроизведения запуска с незакоммиченными изменениями нужно также сохранить сами исходные файлы: одного хеша для их восстановления недостаточно.
Сохранённый базовый прогон с фильтрацией кандидатов показывает Recall@10 72.2%, Precision@5 13.3% и долю ложноположительных срабатываний 100% на шести запросах без ответа. Для каждого из 18 запросов с ответом размечена одна цель, поэтому потолок Precision@5 составляет 20%. Эти показатели описывают корпус из 24 проверок, а не общее качество продукта; пороги остаются прежними. Одновременная работа других заданий брокера и недоступная телеметрия очереди и размещения моделей в памяти не позволяют использовать длительности этого прогона как изолированный тест производительности. Независимые корпуса собраны в закрытой задаче #601; их базовый прогон — в разделе «Независимые корпуса для проверки качества».
Чего нет в консоли. lsp_open_document и lsp_close_document принимают текст
несохранённого буфера — а в командной строке этого буфера просто нет, отдавать нечего.
Чего нет в MCP. Семь команд намеренно оставлены только Вам. Причины три:
Это уже делается само — звать не надо.
localai prune— каждая успешная синхронизация удаляет устаревшие поколения, overlay и staging своего репозитория и сообщает, что удалила, если что-то удалила.localai pruneделает то же для всех репозиториев и вдобавок чистит архив очереди, телеметрию старше срока хранения, записи брошенных репозиториев, старые установленные версии и резервные копии launcher.localai sync— после коммита, checkout, merge и rebase его запускают Git-хуки, поставленныеlocalai hooks install. У агента естьindex_refresh: он запускает ту же синхронизацию с ограничением объёма — для сохранённых, но ещё не закоммиченных правок и после коммита, на котором хук не сработал. Первую сборку или переключение ветки, меняющее большую часть дерева, он отклоняет и возвращает команду для фонового запуска.
Это обновление продукта, и запускают его вручную.
localai updateскачивает самый новый проверенный релиз, ставит его бинарники новой версией и переключает на неё launcher. Модели, зависимости и регистрации клиентов не меняются: клиенты получают новую версию через launcher, на который уже зарегистрированы. Запускайте команду, когда решите обновиться. Если релиз также меняет инструкции клиентов, запустите егоLocalAi.Installer.exe, выбрав нужный клиент: обновление только runtime эти инструкции не переписывает.
Это сведения для Вас, в удобном для чтения виде.
Агенту они не нужны в таком виде — у него на каждый свой вызов есть отчётная строка, а про
индекс отвечает index_status. А человеку нужна общая картина:
localai doctor— что не так с установкой: версия и её файлы, брокер и его очередь, каталог моделей и есть ли у каждой задачи установленная модель, файлы политик, последняя проверка обновлений и репозиторий, в котором Вы находитесь (или указанный в--root). Только чтение, ничего не запускает и не чинит. Строка репозитория разделяет доступный индекс, поколение и навигацию этого рабочего дерева и общее состояние с прогрессом синхронизации. Готовое дерево может иметь статусCurrent, пока синхронизация другого дерева не завершена.Recentозначает недавнюю запись прогресса, но не доказывает, что процесс работает; незавершённый прогресс старше пяти минут —Interrupted. Это не подтверждает готовность всех деревьев. JSON явно разделяет оба уровня состояния и указывает затронутое рабочее дерево. Проверка семантических данных только читает до 4 КиБ:HeaderOnlyподтверждает совпадение заголовков, но не целостность всех данных и не готовность навигации. Эта неопределённость даётUnknownв строке doctor; сама навигация проверяет свой снимок перед ответом. Нечитаемый заголовок или запись общего прогресса явно отмечаются, а известные сведения о рабочем дереве сохраняются. Каждая проверка заканчивается статусомOk,Warning,UnknownилиFailed. Вердикт —Failed, если хоть одна проверка не прошла, иначеWarning, если есть предупреждения, иначеOk; код выхода равен 1 только приFailed.Unknownзначит, что на этой машине нет достоверного и актуального ответа на вопрос проверки; этот статус не меняет ни вердикт, ни код выхода.task-modelsберёт установленные модели из списка, который брокер записывает при запуске, каждые 15 минут, пока работает, и всякий раз, когда выбирает модель для задачи или отвечает наlocalai model status; если списку больше 30 минут, проверка возвращаетUnknown.--jsonотдаёт вердикт вместе со счётчикамиfailed,warnedиunknown; вердиктOkможет прийти и приunknownбольше нуля.localai telemetry— уникальные задания, попытки, известные рабочие процессы и вызовы с подтверждённой доставкой результата. Таблицы моделей и профилей показывают исходы и длительности попыток; входные и выходные облачные токены считаются отдельно, с указанием числа вызовов с известной и неизвестной оценкой.codesearch scan— что вообще попадёт в индекс. Смотрят при настройке репозитория, чтобы понять объём работы, а не при ответе на вопрос о коде.codesearch evaluate— прогон корпуса качества поиска. Инструмент разработки самого Local AI, а не работы с Вашим кодом.
← Что доступно облачному агенту · Оглавление · Поиск по коду — не текстовый поиск →