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

Дёргать инструменты руками не нужно - агент вызывает их сам. Справочник пригодится, если хочется понимать, что происходит, или написать свою инструкцию в 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) - подтвердить загрузку крупного файла после отправки.

Задачи

• list_tasks(project_id) - открытые задачи, которые вы поставили агенту из Telegram или мини-аппа.
• complete_task(task_id, result) - закрыть задачу и написать, что именно сделано. Вы получите уведомление в Telegram, задача перестанет всплывать.

Мост в Telegram

• notify_me(text) - сообщение вам в личку от агента: «тесты зелёные», «сборка упала». До 1000 символов.
• set_reminder(text, when) - напоминание на конкретное время, придёт от Чипа.
• ask_user(question, options) - вопрос с кнопками, когда агент упёрся в развилку, которую решаете вы. Он подождёт ответа около минуты.
• check_confirmation(ask_id) - забрать ответ, если вы не успели ответить сразу.
• generate_image(prompt, project_id) - картинка 1024×1024. Единственный инструмент, который списывает кредиты (около 8 за штуку).

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

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

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

Если токен выпущен в режиме «Чтение», агент видит только читающие инструменты: 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. Список вдвое короче - старт сессии дешевле примерно на 2000 токенов. Пишущие инструменты не просто спрятаны: если агент вызовет их по имени в обход списка, он получит отказ.