sudocode CLI
Слой памяти и координации для кодовых агентов: спецификации и задачи лежат в git, а агенты работают параллельно
- 295 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Запускает кодовых агентов параллельно, они правят файлы, создают ветки, рабочие деревья и коммиты
- Локальный сервер управляет выполнением агентов
- Агенты в MCP получают доступ к чтению и записи задач и спецификаций проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/sudocodeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает кодовых агентов параллельно, они правят файлы, создают ветки, рабочие деревья и коммиты
- Локальный сервер управляет выполнением агентов
- Агенты в MCP получают доступ к чтению и записи задач и спецификаций проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
sudocode добавляет в репозиторий систему памяти и координации для кодовых агентов. Требования человека живут в спецификациях и отвечают на вопрос, что нужно сделать. Планы и контекст агента живут в задачах и описывают, как это реализовать. Те и другие лежат в git, их читают и правят и люди, и агенты. Агент может оставить в задаче заметки для следующего, поэтому контекст длинной работы не теряется между сессиями. В пакет входят CLI, локальный сервер с интерфейсом и MCP-сервер. CLI управляет спецификациями, задачами и связями между ними, а сервер синхронизирует память и показывает канбан задач, редактор спецификаций и панель выполнения. Из интерфейса можно запускать Claude Code, Codex, Cursor и других агентов параллельно, давать им обратную связь и смотреть траектории. Когда задачи связаны зависимостями, граф можно выполнить как рабочий процесс. Задачи идут в топологическом порядке, изменения копятся во временной ветке или рабочем дереве, и каждая задача получает отдельный коммит.
Для кого. Для разработчиков, которые ведут большие задачи с несколькими кодовыми агентами и хотят хранить намерения и планы в репозитории.
Подходит, если
- Задача длинная, и контекст нужно передавать между сессиями агента в виде файлов в git
- Требования и план надо разделить: спецификации для человека, задачи для агента
- Хочется запускать нескольких агентов параллельно и видеть их работу в одном канбане
- Граф задач с зависимостями должен выполниться по порядку с отдельным коммитом на каждую
- Вы уже используете Spec-Kit, OpenSpec или Beads и хотите синхронизацию с ними
Не подходит, если
- Правка небольшая и делается за одну сессию: система спецификаций и задач будет лишней
- Нельзя запускать агентов с правом менять код и создавать ветки и рабочие деревья
- Нужна интеграция с Jira или Linear уже сейчас: она пока только в планах
- Вы не хотите держать в репозитории папку .sudocode с данными в формате JSONL
Пример запроса к агенту
Создай спецификацию auth-system, разложи ее на задачи с зависимостями и запусти выполнение в порядке графаОграничения
- Автор советует запускать sudocode через npx, чтобы глобальная установка не вызвала конфликт версий Node.
- Интеграции с Jira и Linear еще не готовы.
- Команда планирования, которая сама вызывает настроенного агента, пока только в планах, поэтому план агенту приходится заказывать вручную.
- Автосинхронизация между Markdown и JSONL идет с задержкой около пяти секунд, а конфликты слияния разрешают git и ИИ.
Как отключить. Удалите папку .sudocode из репозитория и пакет командой `npm uninstall -g sudocode`. Плагин для Claude Code снимите командой `claude plugin uninstall sudocode`.
Частые вопросы
Как поставить sudocode?
Выполните `npm install -g sudocode`, затем `sudocode init` в корне проекта и `sudocode server` для интерфейса. Автор советует npx вместо глобальной установки, если возникают конфликты версий Node.
Как подключить sudocode к Claude Code?
Командами `claude plugin marketplace add sudocode-ai/sudocode` и `claude plugin install sudocode`. Для других агентов в репозитории есть руководство быстрого старта.
Чем спецификация отличается от задачи?
Спецификация хранит намерение человека: требования, решения, исследовательские вопросы. Задача хранит намерение агента: что сделать по спецификации. Между ними есть связи по ссылкам вида [[@ISSUE-001]].
Где хранятся данные?
В папке .sudocode: источником правды служат файлы JSONL и Markdown в git, а кэш SQLite в cache.db лежит локально и в git не попадает.
С какими системами работает синхронизация?
С Beads, Spec-Kit и OpenSpec, в обе стороны. Включить интеграции можно в разделе Settings, Integrations или командой `sudocode plugin`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПереносимая папка .agent с памятью, скиллами и протоколами, которая подключается к разным кодовым агентам и не теряет знания при смене инструмента
TUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Общая локальная память для Codex, Claude Code, Cursor, Hermes Agent и OpenClaw: агенты передают задачи, проверяют друг друга и ночью дорабатывают скиллы
CLI Agent Orchestrator
CLI Agent Orchestrator (CAO)
CLI, который координирует несколько кодовых агентов: супервизор раздает задачи специалистам параллельно или по очереди в отдельных сессиях tmux
Оркестратор для агентов: рабочий процесс описывается кодом, каждый шаг проверяется, важные места требуют подтверждения человека, а решения пишутся в неизменяемы
Память для кодинговых агентов на обычных Markdown-файлах: агент сам ведет спецификации, решения и уроки, а новая сессия начинает с них, без векторной базы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| sudocode (эта запись) | нет | 295 | |
| OpenSpec | нет | 73 280 | процесс предложений и спецификаций без запуска агентов, а здесь еще память задач и параллельное выполнение |
| Agent Kanban | нет | 493 | скиллы для доски задач в стороннем сервисе, а здесь доска и память живут в вашем git |
| CLI Agent Orchestrator | нет | 1 485 | супервизор раздает задачи агентам в терминале, а здесь граф спецификаций и задач в репозитории |
Коротко о README
Главная идея проекта — контекст как код: репозиторий становится распределенной базой памяти, где данные раздает git. Пошаговый пример ведет от спецификации до исполнения.