Ank CLI
CLI хранит задачи и архитектурные решения в репозитории, чтобы любой кодирующий агент читал их и брал работу.
- 93 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Пишет и меняет файлы задач и решений в `.ank/` и запускает объявленные проверки командой `ank done`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ankОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Пишет и меняет файлы задач и решений в `.ank/` и запускает объявленные проверки командой `ank done`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ank хранит решения и задачи в папке `.ank/` рядом с кодом, который они ограничивают, и выдает их через один CLI. Агент видит весь код, а трекер, вики и ветка обсуждения, где решили, что сессии не должны быть самодостаточными JWT, ему недоступны. Ank делает такие решения доступными в рабочем цикле. Цикл состоит из команд: `ank context <путь>` показывает, что связывает область и что можно взять, `ank claim <id>` берет задачу и замораживает критерий, `ank show <id>` выводит сущность целиком, `ank log` записывает, что узнано по ходу, `ank done` запускает объявленные проверки и сохраняет доказательство, `ank release` возвращает задачу. Формат файлов и коды выхода описаны спецификацией, версия 0.x: формат может измениться до 1.0 через новое значение `schema`.
Для кого. Командам и одиночным разработчикам, которые работают с агентами и хотят хранить решения и задачи в репозитории рядом с кодом.
Подходит, если
- Архитектурное решение не должно теряться: агент обязан видеть ограничение до правки соответствующего кода.
- Агентам нужна общая очередь задач в репозитории с критерием приемки, замороженным при взятии.
- Проверки задачи должны запускаться командой `ank done` и оставлять доказательство.
- Хочется возвращать задачу с причиной через `ank release --reason`.
Не подходит, если
- Нужен трекер со спринтами, оценками и дорожной картой: Ank их сознательно не содержит.
- Нужна вики для общих знаний: сюда попадает только то, что обязывает агента или требует действия.
- Требуется граница безопасности: от дрейфа он защищает, злоумышленника не остановит.
Пример запроса к агенту
Покажи ank context для папки auth и возьми доступную задачу с критерием приемки.Ограничения
Версия 0.x: автор оставил право менять формат файлов до 1.0, об изменении сообщит новое значение `schema`. Нужен git 2.34 или новее, платформы Linux, macOS и Windows. Бинарник ставится командой `npm install -g @haksolot/ank`, скиллы отдельно командой `npx skills add haksolot/ank`. Ank не трекер, не вики и не граница безопасности: он защищает от расхождения решений и кода, злонамеренные правки не его забота. Лицензия Apache-2.0. Начните с руководства быстрого старта, оно проходит цикл от `ank init`.
Как отключить. Удалите пакет командой `npm uninstall -g @haksolot/ank` и скиллы из каталога агента. Папка `.ank/` остается в репозитории как обычные файлы Markdown.
Частые вопросы
Какие команды составляют цикл?
`ank context`, `ank claim`, `ank show`, `ank log`, `ank done` и `ank release`.
Где лежат данные?
В папке `.ank/` репозитория, включая архив сущностей в `.ank/archive/entities/`. Это обычные файлы под управлением git.
Что Ank не заменяет?
Трекер, вики и границу безопасности. Он держит только то, что обязывает агента или требует действия.
Что делает `ank done`?
Запускает объявленные проверки задачи и записывает доказательство их результата.
Как поставить?
`npm install -g @haksolot/ank` для бинарника и `npx skills add haksolot/ank` для скиллов агента. Нужен git 2.34 или новее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЗадачи, документы, спецификации и решения проекта лежат файлами Markdown в репозитории, а агент читает их через CLI и MCP
Режимы работы для ИИ-агента: облегченный на каждый день и /man с планом, проверкой и ревью для крупных задач
Git-нативный контекст проекта для агентов: спецификации, решения и правила лежат в Markdown рядом с кодом и читаются перед правкой
Настольная доска запускает карточку как сессию агента в своем git worktree, показывает, какой агент ждет вас, и дает MCP-сервер
CLI записывает сессии кодинг-агентов локально, повторяет ход работы и показывает, чего трасса не смогла доказать.
Kanban от Cline запускает локальную веб-доску, где каждая карточка получает свой терминал и git worktree для CLI-агента.
Коротко о README
README объясняет идею хранения решений рядом с кодом, показывает установку, цикл команд и перечень задач, которые инструмент не берет на себя. Спецификация формата и документация вынесены в отдельные ссылки.