sessions: постоянная память и список задач для Claude Code и ИИ-агентов

Память проекта для ИИ-агентов, которая переживает /clear, /compact и новые сессии

Каждая сессия Claude Code начинается с нуля, а параллельные агенты ничего не знают друг о друге. sessions хранит «книги сессий» проекта (session books) в базе данных, а не в markdown-файлах в репозитории: передачу смены от прошлой сессии (handoff), журнал открытых задач (pending ledger), хронику сделанного (chronicle), постоянные правила (invariants: правила и зоны «не трогать») и длинные документы. Агент читает всё это одним вызовом в начале сессии и записывает результат одним вызовом в конце.

Несколько worktree, машин и агентов пишут в одни и те же книги одновременно и без конфликтов, потому что арбитр здесь база данных, а не git. Сервис начинался как память для агентов-программистов и так же хорошо работает как список дел на каждый день (см. Задачи на день).

Передача смены, журнал задач и общие книги

• Pickup и handoff

  session_pickup одним чтением возвращает последнюю передачу смены, открытые задачи, недавнюю историю и правила проекта; session_handoff фиксирует конец сессии одной транзакцией.

• Журнал задач с рекомендательными claim

  Открытые задачи с приоритетами; агент берёт задачу в работу (claim), чтобы остальные видели, что она занята. Это пометка, а не блокировка.

• Хроника

  История сделанного, в которую только дописывают; поиск по всем проектам (session_search).

• Инварианты

  Постоянные правила, которые обязан соблюдать следующий агент: зоны «не трогать», особенности окружения, политики, аварийные выключатели.

• Документы и картинки

  Планы, макеты и записи о решениях, прикреплённые к задачам; скриншоты, прикреплённые к записям.

• Аренды деплоя

  Рекомендательные пометки о том, кто и что выкатывает на какую цель.

• Много агентов сразу

  Несколько worktree, машин и параллельных агентов на одном проекте; каждая запись сообщает, что изменили другие с момента вашего последнего чтения.

• Группы проектов

  Владелец объединяет проекты в группу, и их агенты читают книги друг друга, отправляют друг другу запросы и документы в списки задач.

• Индекс кода (необязательно, по умолчанию выключен)

  Его включает владелец: основная ветка проекта индексируется и доступна для поиска по тексту и, по желанию, по смыслу (embeddings), обновляется автоматически. Нужны адрес git-репозитория проекта и ключ развёртывания GitHub только для чтения, который добавляет администратор репозитория.

• Навыки с сервера

  На клиенте остаются только небольшие заглушки; каждая слэш-команда приходит с сервера в актуальной версии (см. Навыки).

• Изоляция и безопасность

  Один токен - один проект; токены хранятся только как sha256 и отзываются мгновенно; удалённый проект неделю лежит в карантине и может быть восстановлен.

Инструменты MCP

Сервер предоставляет восемь инструментов:

• session_pickup
• session_note
• session_handoff
• session_read
• session_search
• session_knowledge
• session_project
• session_skill

Как подключить HTTP MCP-сервер с bearer-токеном в Claude Code

Четыре шага. Токен привязан к проекту и показывается только один раз.

1. Войдите в кабинет abt.nz, откройте вкладку Сессии, создайте проект по имени (1-64 символа: строчные буквы, цифры, _ и -, начинается с буквы или цифры; имена не обязаны быть уникальными) и выпустите токен проекта. Токен показывается ОДИН раз. Адрес git-репозитория необязателен и добавляется позже; он нужен только для индекса кода.

2. В репозитории (или в папке, из которой вы работаете) зарегистрируйте сервер приватно. Локальная область (local scope) означает, что токен никогда не попадёт в коммит:

   claude mcp add --transport http --scope local sessions https://sessions.abt.nz/mcp \
       --header "Authorization: Bearer <token>"

3. Один раз на каждой машине попросите агента: install the sessions skills. Он покажет заглушки и запишет их после вашего подтверждения.

4. Начинайте каждую сессию с /pickup, заканчивайте /handoff (см. Навыки).

Другие MCP-клиенты

Подойдёт любой клиент со streamable HTTP и заголовком bearer. Не коммитьте токен: держите этот файл вне системы контроля версий.

{"mcpServers": {"sessions": {"type": "http", "url": "https://sessions.abt.nz/mcp", "headers": {"Authorization": "Bearer <token>"}}}}

Навыки Claude Code и рабочий цикл: pickup, askme, orchestrate, handoff

Навыки - это слэш-команды, которые раздаёт сервер. Они образуют один цикл, и каждый шаг дёшево повторить:

1. /pickup - начало каждой сессии. Одно чтение книг; агент говорит, где вы остановились, что в работе, что ждёт, что не трогать и с чего начать. Дёшево повторить после сжатия контекста.
2. /askme [задача] - договориться о задаче ДО начала работы. Агент пересказывает задачу простыми словами, затем задаёт вопросы по одному (сначала рекомендуемый вариант, и никогда не спрашивает то, что уже есть в коде или в книгах) и один раз записывает итог: документ с решениями, связанный с карточкой задачи. Код не пишет.
3. /orchestrate <задача> - оркестрация агентов: агент становится оркестратором и проводит задачу по собственной дисциплине проекта: план, реализация субагентами, ревью, проверки, PR, слияние и деплой; шаги, специфичные для проекта, берутся из правил проекта (.claude/orchestrate.md или раздел "## Orchestrate" в CLAUDE.md). Печатается первым словом сообщения.
4. /handoff - конец сессии. Одна транзакция: короткий указатель для следующей сессии (что делать первым), записи хроники о сделанном, открытые, закрытые и переформулированные задачи, записанные правила, приложенные документы.
5. /clear или /compact - собственные команды Claude Code для сброса или сжатия контекста. Ничего не теряется: состояние хранится в книгах, и следующий /pickup восстанавливает картину одним вызовом.

Другие навыки

• /ledger-loop - самостоятельно разбирает открытые задачи, начиная со старых: проверяет, что задача ещё актуальна, берёт её в работу, делает, открывает PR и останавливается на зелёных проверках; ничего не сливает; на каждый запуск есть жёсткие лимиты.
• /sweep <область> - уборка с картой покрытия: сканирует одну область на мёртвый код, дублирование и устаревшие тесты и выдаёт отчёт; удаление только отдельным подтверждённым запуском.
• /knowledge-onboard - включает индекс кода и передаёт владельцу репозитория ключ развёртывания только для чтения.

Установка один раз на машину: попросите агента install the sessions skills; он покажет заглушки и запишет их после вашего подтверждения.

Не только код: ИИ-менеджер задач и список дел на день с Claude

sessions не привязан к программированию. Те же книги работают как личный или командный список дел на каждый день, которым управляет ИИ-агент:

• Журнал = список дел: задачи с приоритетами (CRITICAL, HIGH, MEDIUM, LOW ...), берутся в работу, закрываются с резолюцией; долгоживущие пункты остаются открытыми намеренно.
• Хроника = дневник того, что сделано и когда, с поиском.
• Документы = заметки: планы, решения, заметки со встреч, исследования, прикреплённые к своей задаче.
• Инварианты = постоянные правила: что всегда соблюдать и чего никогда не трогать.
• Ритм дня: утренний /pickup даёт повестку (вчерашняя передача смены, открытые задачи по приоритету); /askme превращает расплывчатую задачу в договорённую; работа дня записывается по ходу; вечерний /handoff оставляет первый шаг на завтра.
• Везде: один и тот же список с любой машины, где работает агент; проекты нескольких людей можно объединить в группу, чтобы они отправляли задачи в списки друг друга.

Примеры

Планирование недели, воронка найма, дела небольшого бизнеса, исследование с заметками по темам, домашние дела.

Проект создаётся по имени; git-репозиторий необязателен и добавляется позже (например, github.com/you/repo). Он нужен только для индекса кода. Списку задач не про код, исследованиям и документам репозиторий не нужен вовсе.

Сколько стоит sessions

Бесплатно, пока не заработала оплата. Списания начнутся, когда на abt.nz заработает оплата; до тех пор sessions бесплатен.

• Бесплатно

  До 300 МБ на проект (книги + индекс кода + векторы).

• 60 руб. за ГБ

  Сверх 300 МБ: 60 руб. за каждый начатый ГБ в месяц, списывается ежедневно с кошелька владельца в abt.nz; квота и округление считаются по каждому проекту.

• Если не оплачено

  Не оплачено 3 дня: только проекты сверх бесплатных 300 МБ становятся доступны только для чтения до оплаты; чтение работает всегда; данные никогда не удаляются; бесплатные проекты продолжают работать.

Лимиты

• До 10 собственных проектов, 20 активных токенов и 20 групп на пользователя.
• Лимит запросов к /mcp для токенов кабинета: 120 запросов в минуту, всплеск 30, на каждый токен; все токены пользователя вместе получают вдвое больше.

Частые вопросы