Все инструменты Чипа

Дёргать инструменты руками не нужно - агент вызывает их сам. Справочник пригодится, если хочется понимать, что происходит, или написать свою инструкцию в CLAUDE.md.

С чего начинается сессия

• whoami - тариф и занятость слотов проектов. Один раз в начале, чтобы агент знал ваши лимиты.
• list_projects - список проектов с id и датой активности. Нужен, чтобы выбрать, с чем работать.
• whats_new(project_id) - что изменилось с прошлого захода этой машины: новые записи журнала, задачи, файлы, обновлённые полочки, диалоги. Главная точка входа в повторную сессию.
• get_project_context(project_id) - полный бриф проекта: инструкции, задачи, оглавление карты, память, файлы, диалоги. Нужен один раз, когда агент видит проект впервые.

Чтение знания

• get_project_map(project_id) - оглавление карты: список полочек-статей, которые Чип ведёт по журналу.
• read_map_section(project_id, section) - статья одной полочки: актуальное знание по теме.
• read_journal(project_id, offset) - журнал хронологически, дословно. Когда нужна точная формулировка или «что было N сессий назад».
• search_project(query, project_id) - поиск по полочкам, журналу, памяти и диалогам. Без project_id ищет сразу по всем проектам - когда помните факт, но не помните, где он.
• read_project_dialog(project_id, session_id) - ваш диалог с Чипом внутри проекта. Сценарий: надиктовали план с телефона - агент забирает его целиком, а не в пересказе.
• list_files и read_project_file - файлы базы знаний проекта и их текст кусками.

Запись знания

• save_session_summary(project_id, text) - сводка сессии в журнал: сделано, решения и почему, грабли, следующий шаг. Вызывается в конце работы, один раз.
• add_note(project_id, text, kind) - короткая заметка в память проекта. kind решает судьбу заметки: decision уходит на отдельную полку «Решения» и оттуда не пропадает, fact - как устроено, preference - как вы любите, progress - что сделано. Решение агент записывает формулой «что решали → выбрали X вместо Y, потому что Z»: без «почему» следующая сессия переспорит то же самое.
• upload_project_file(project_id, filename, ...) - выгрузить в проект текстовый файл (md, txt, csv, json), чтобы вы открыли его с телефона. Мелкое уходит сразу, крупное - по ссылке, которую агент получает в ответ.
• finalize_upload(upload_id) - подтвердить загрузку крупного файла после отправки.
• Обратная сторона: весь проект целиком забирается архивом - кнопка «Архив проекта» в мини-аппе (пришлёт .zip в чат) и в кабинете на сайте (скачает файлом). Внутри журнал, полочки карты, память, задачи и текст файлов; распакованная папка открывается как хранилище Obsidian, ссылки между полочками живые.

Задачи

• list_tasks(project_id) - открытые задачи, которые вы поставили агенту из Telegram или мини-аппа.
• complete_task(task_id, result) - закрыть задачу и написать, что именно сделано. Вы получите уведомление в Telegram, задача перестанет всплывать.
• add_task(project_id, text) - агент оставляет поручение сам себе на следующую сессию: хвост из «Осталось», который не успел доделать. Вы увидите его в мини-аппе, следующая сессия - в list_tasks.

Мост в Telegram

• notify_me(text, upload_id) - сообщение вам в личку от агента: «тесты зелёные», «сборка упала». До 1000 символов. С upload_id придёт ещё и файл.
• attach_file(filename, size_bytes) - вложение к следующему notify_me: скриншот после правки интерфейса, PDF, хвост лога. Агент получает ссылку, кладёт файл напрямую (мимо своих токенов) и передаёт upload_id в notify_me. Форматы: png, jpg, jpeg, gif, webp, pdf, txt, md, log, csv, json; до 5 МБ на файл. HTML не принимаем намеренно: содержимое вложения не проверяется, и страница, открытая из чата с ботом, выглядела бы как сообщение от Чипа. В проект такой файл НЕ сохраняется - он живёт до отправки и удаляется.
• set_reminder(text, when) - напоминание на конкретное время, придёт от Чипа.
• ask_user(question, options) - вопрос с кнопками, когда агент упёрся в развилку, которую решаете вы. Он подождёт ответа около минуты.
• check_confirmation(ask_id) - забрать ответ, если вы не успели ответить сразу.
• generate_image(prompt, project_id) - картинка 1024×1024. Единственный инструмент, который списывает кредиты (около 3 за штуку).

Управление проектами

• create_project(name) - завести проект.
• rename_project(project_id, name) - переименовать, только по вашей явной просьбе.
• archive_project(project_id) - убрать проект из списка и освободить слот. Данные сохраняются. Удалить проект насовсем можно только вам самим, в мини-аппе.

Слэш-команды: сессия в одну строку

Кроме инструментов сервер отдаёт три готовых сценария. В Claude Code они видны как слэш-команды: наберите / и выберите нужную, объяснять агенту ничего не надо.

• /mcp__chip__start - начало сессии: агент разом получает whats_new (что изменилось с прошлого захода) и список открытых поручений, одним сообщением и без лишних вызовов.
• /mcp__chip__finish - конец сессии: шаблон сводки по структуре Сделано → Решения и почему → Грабли → Осталось, с напоминанием продублировать решения и грабли заметками, а хвосты - задачами.
• /mcp__chip__pitfall - записать граблю, пока помните симптом: симптом → причина → лечение, коротко.

Токену в режиме «Чтение» доступна только start: две другие команды пишут в проект.

Ресурсы: полочка памяти по @

Память проекта доступна ещё и ресурсами - клиент подставляет их по @, как файл из репозитория. В Claude Code это выглядит как @chip:chip://project/2/decisions: агент получает полку «Решения» целиком. Так же берутся контекст проекта (context), поручения (tasks), последние сводки (journal), грабли (pitfalls) и любая полочка карты (map/<id>). Удобно, когда вы точно знаете, что агенту нужно прочитать, и не хотите ждать, пока он догадается сам.

Токен «Чтение»: 11 инструментов из 27

Если токен выпущен в режиме «Чтение», агент видит только читающие инструменты: whoami, list_projects, whats_new, get_project_context, read_journal, read_map_section, read_project_dialog, read_project_file, list_files, list_tasks, search_project. Список вдвое с лишним короче - старт сессии дешевле примерно на 1750 токенов. Пишущие инструменты не просто спрятаны: если агент вызовет их по имени в обход списка, он получит отказ.