Knowns CLI
Задачи, документы, спецификации и решения проекта лежат файлами Markdown в репозитории, а агент читает их через CLI и MCP
- 251 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Команды `setup` пишут конфигурацию MCP, скиллы и хуки в каталоги агента
- Установщик npm получает исполняемый бинарник из внешнего источника
- Агент через MCP получает чтение и запись задач, документов и памяти проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/knownsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команды `setup` пишут конфигурацию MCP, скиллы и хуки в каталоги агента
- Установщик npm получает исполняемый бинарник из внешнего источника
- Агент через MCP получает чтение и запись задач, документов и памяти проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Knowns — консольная программа, которая хранит контекст проекта для ИИ-агента в каталоге `.knowns/` внутри репозитория. Там лежат задачи с критериями приемки и планом реализации, вложенные документы в Markdown со ссылками друг на друга, спецификации, шаблоны для генерации кода и память трех уровней: проекта, сессии и общая. Ссылки вида `@doc/patterns/auth` и `@task-KN-4F7Q2M` агент может разворачивать сам. Файлы обычные, их можно коммитить в Git, облако не нужно. Агент получает этот контекст через MCP-сервер и через команды CLI. Семантический поиск использует локальные модели ONNX. Команда `knowns doctor` перед работой проверяет настройку проекта, поиск, языковые серверы и подключения к агентам. Для кода есть LSP-инструменты: символы, определения, ссылки и правки по символам. Для Claude Code и Codex программа синхронизирует набор скиллов `/kn-*` и `$kn-*`: `kn-init` читает документы и загружает память, `kn-plan` составляет план по задаче, `kn-implement` выполняет его и отмечает критерии, `kn-review` делает обзор кода с приоритетами P1–P3, `kn-commit` готовит коммит. Системные решения хранятся отдельными записями: новое решение начинается черновиком и становится действующим после проверки связанных доказательств.
Для кого. Для разработчиков и команд, которые каждый день работают с Claude Code, Codex, Cursor или OpenCode и устали объяснять агенту архитектуру в начале каждой сессии.
Подходит, если
- Нужно хранить принятые решения в репозитории как записи с жизненным циклом, чтобы агент не забывал их между сессиями
- Нужно вести задачи с критериями приемки так, чтобы агент сам проверял их выполнение
- Нужен поиск по смыслу без интернета в проекте с большой документацией
- Нужно дать новым участникам и агентам команды единый контекст в каталоге `.knowns/`
- Нужны шаблоны Handlebars для генерации однотипного кода через команду `knowns template run`
Не подходит, если
- Проект крошечный, и хватает одного файла `CLAUDE.md` или `AGENTS.md`
- Нужен облачный трекер задач с совместным доступом: Knowns хранит данные локально в файлах
- Нужна только память для разговоров с ассистентом без привязки к репозиторию
Пример запроса к агенту
Выполни `/kn-plan 42`: возьми задачу, прочитай связанные документы и составь план, потом жди моего подтвержденияОграничения
Готовые бинарники работают на Windows, macOS и Linux. Установка через npm использует обертку: она получает платформенный пакет или скачивает архив из GitHub Releases. Go нужен только для сборки исходников. Для первого семантического поиска может потребоваться загрузка модели, после которой индекс обрабатывается локально.
Команда `knowns setup` записывает конфигурации, скиллы и для части клиентов хуки. Глобальную настройку можно выполнить отдельно; проектная требует каталога `.knowns`. Через MCP документы и код получает ваш агент, а приватность зависит от его модели и Git-сервера, куда вы отправляете репозиторий. Командная синхронизация пока заявлена в планах.
Как отключить. Удалите конфигурацию MCP и скиллы, которые добавил `knowns setup`, затем удалите каталог `.knowns/` и файлы-подсказки из проекта. Саму программу снимает `npm uninstall -g knowns` или `brew uninstall knowns`.
Частые вопросы
Как подключить Knowns к Claude Code?
Установите программу, выполните `knowns init` в проекте, затем `knowns setup claude --global`. Агент получит MCP, скиллы `/kn-*` и хуки памяти среды выполнения. Для Codex команда `knowns setup codex --global`, для OpenCode `knowns setup opencode --global`.
Где Knowns хранит данные и можно ли ими делиться через Git?
Да. Данные лежат в каталоге `.knowns/` в репозитории обычными файлами. Их можно коммитить, и коллеги получат те же задачи, документы и память после клонирования. Командой `knowns doctor` стоит проверить проект после клона.
Чем системные решения отличаются от решений в спецификации?
Решения спецификации — закрепленные правила D1, D2 и так далее внутри утвержденной спецификации, которые обязан соблюдать исполнитель. Системные решения — отдельные записи о долгих изменениях проекта: они создаются черновиком и становятся действующими после проверки связанных источников.
Нужен ли ключ для семантического поиска?
Нет, для локальной модели ключ API не нужен. Сначала подготовьте ее командой `knowns search --setup` и перестройте индекс. После загрузки модели поиск не требует внешнего API; для первой загрузки модели нужна сеть.
Как открыть веб-интерфейс Knowns?
Командой `knowns browser --open`. Откроется локальная страница с канбан-доской задач, обзором документов, графом знаний и диаграммами `mermaid`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыБольше двадцати скиллов для кодовых агентов: MCP и хуки, режим плана, протокол багфикса, промпты и защитный хук для bash
Режимы работы для ИИ-агента: облегченный на каждый день и /man с планом, проверкой и ревью для крупных задач
CLI, который создает и поддерживает файлы контекста для кодовых агентов: CLAUDE.md, правила Cursor, AGENTS.md и инструкции Copilot, и держит их в актуальном вид
Терминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
Агент для программирования на Rust с графическим окном, терминалом, режимом ACP для Zed и MCP-сервером
Рабочая конфигурация Claude Code: планировщик с ревью по этапам, субагенты и скиллы анализа, рефакторинга и синхронизации документации
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Knowns (эта карточка) | нет | 251 | ||
| Spec Kit | нет | 147 764 | CLI specify ставит в проект команды для разработки от спецификации; Knowns хранит задачи, документы и память | |
| Trellis | нет | 15 100 | каркас рабочего процесса: спецификации, задачи и журналы сессий тоже лежат в репозитории | |
| Basic Memory | нет | не нужна | 4 495 | долговременная память агента в Markdown-файлах; Knowns добавляет задачи с критериями приемки |
Коротко о README
Локальная веб-страница показывает задачи на канбан-доске, документы и связи между ними. Программа распространяется по MIT; данные можно просматривать и редактировать как обычные файлы проекта.