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

**sessions - это облачный MCP-сервер, который даёт ИИ-агентам общую постоянную память и список задач: продолжить с того места, где остановилась прошлая сессия, чисто передать смену (handoff) и согласовать работу нескольких агентов, worktree и машин над одним проектом.**

HTML: https://abt.nz/sessions/ru/ | [English](https://abt.nz/sessions/en/)

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

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

Несколько worktree, машин и агентов пишут в одни и те же книги одновременно и без конфликтов, потому что арбитр здесь база данных, а не git. Сервис начинался как память для агентов-программистов и так же хорошо работает как список дел на каждый день (см. [Задачи на день](https://abt.nz/sessions/ru/#tasks)).

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

- **Pickup и handoff**: `session_pickup` одним чтением возвращает последнюю передачу смены, открытые задачи, недавнюю историю и правила проекта; `session_handoff` фиксирует конец сессии одной транзакцией.
- **Журнал задач с рекомендательными claim**: Открытые задачи с приоритетами; агент берёт задачу в работу (claim), чтобы остальные видели, что она занята. Это пометка, а не блокировка.
- **Хроника**: История сделанного, в которую только дописывают; поиск по всем проектам (`session_search`).
- **Инварианты**: Постоянные правила, которые обязан соблюдать следующий агент: зоны «не трогать», особенности окружения, политики, аварийные выключатели.
- **Документы и картинки**: Планы, макеты и записи о решениях, прикреплённые к задачам; скриншоты, прикреплённые к записям.
- **Аренды деплоя**: Рекомендательные пометки о том, кто и что выкатывает на какую цель.
- **Много агентов сразу**: Несколько worktree, машин и параллельных агентов на одном проекте; каждая запись сообщает, что изменили другие с момента вашего последнего чтения.
- **Группы проектов**: Владелец объединяет проекты в группу, и их агенты читают книги друг друга, отправляют друг другу запросы и документы в списки задач.
- **Индекс кода (необязательно, по умолчанию выключен)**: Его включает владелец: основная ветка проекта индексируется и доступна для поиска по тексту и, по желанию, по смыслу (embeddings), обновляется автоматически. Нужны адрес git-репозитория проекта и ключ развёртывания GitHub только для чтения, который добавляет администратор репозитория.
- **Навыки с сервера**: На клиенте остаются только небольшие заглушки; каждая слэш-команда приходит с сервера в актуальной версии (см. [Навыки](https://abt.nz/sessions/ru/#skills)).
- **Изоляция и безопасность**: Один токен - один проект; токены хранятся только как 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](https://abt.nz/panel/#/s), откройте вкладку **Сессии**, создайте проект по имени (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` (см. [Навыки](https://abt.nz/sessions/ru/#skills)).

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

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

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

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

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

**Цикл текстом:** `/pickup -> /askme -> /orchestrate -> /handoff -> /clear or /compact -> /pickup`

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, на каждый токен; все токены пользователя вместе получают вдвое больше.

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

### Как дать Claude Code память между сессиями?

Подключите sessions как MCP-сервер. Начинайте каждую сессию с /pickup: он одним вызовом читает последнюю передачу смены, открытые задачи, недавнюю историю и правила проекта; заканчивайте /handoff: он записывает состояние обратно одной транзакцией. Память живёт на сервере, а не в файлах вашего репозитория, поэтому переживает новые сессии, новые машины и новые worktree.

### Что делать после /clear или /compact, чтобы агент помнил задачу?

Запустите /pickup. При /clear и /compact ничего не теряется, потому что состояние лежит в книгах; /pickup восстанавливает картину одним дешёвым вызовом: где вы остановились, что в работе, что ждёт, что не трогать и с чего начать. Перед очисткой запустите /handoff, чтобы книги были актуальны.

### Как нескольким агентам Claude Code или worktree пользоваться одним списком задач?

Все подключаются к одному проекту по его токену. В журнале лежат открытые задачи с приоритетами; агент берёт задачу в работу (claim), чтобы остальные видели, что она занята (это пометка, а не блокировка). Записи из нескольких worktree, машин и от нескольких агентов не конфликтуют, потому что арбитр - база данных, а не git, и каждая запись сообщает, что изменили другие с момента вашего последнего чтения.

### Можно ли использовать Claude Code как ежедневный менеджер задач?

Да. Журнал - это список дел, хроника - дневник, документы - заметки, а инварианты - постоянные правила. Утром запустите /pickup, чтобы получить повестку, /askme - чтобы превратить расплывчатую задачу в договорённую, а вечером /handoff, чтобы оставить первый шаг на завтра. Для списка не про код просто создайте проект по имени: git-репозиторий не нужен, он требуется только для индекса кода.

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

Выпустите токен проекта в кабинете abt.nz и выполните в папке проекта: claude mcp add --transport http --scope local sessions https://sessions.abt.nz/mcp --header "Authorization: Bearer <token>". Локальная область (local scope) не пускает токен в репозиторий. Любой другой MCP-клиент со streamable HTTP принимает адрес https://sessions.abt.nz/mcp и заголовок Authorization: Bearer.

### Хранится ли мой токен или код?

Токен показывается один раз; хранится только его sha256, он отзывается мгновенно, и один токен даёт доступ к одному проекту. sessions хранит книги, которые пишут ваши агенты (передачи смены, задачи, историю, правила, документы). Ваш репозиторий сервис не читает, пока владелец не включит необязательный индекс кода: по умолчанию он выключен и использует ключ развёртывания GitHub только для чтения. Удалённый проект неделю лежит в карантине и может быть восстановлен.

### Сколько это стоит?

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

---

[Открыть кабинет](https://abt.nz/panel/#/s) | [ABT](https://abt.nz/) | hello@abt.nz