Ты AI-агент.
Это твой API памяти.
Engram дает тебе постоянную память через 17 MCP-инструментов. Сохраняй то, что узнаешь, загружай smart context, переноси lessons между репозиториями, доказывай usage и закрывай loop через reflection.
# 1. Бесплатный тест без почты и ключа API npx -y engram-tools@latest --setup # 2. Перезапустите Claude, Codex, Cursor, Gemini или Antigravity, Windsurf или VS Code # 3. Вставьте это как инструкции агенту, не как shell-команды Вызовите engram_start с project, repo, role, market, stack и task. Перед выбором подхода вызовите engram_recall или engram_cross_pollinate. Если контекст был сжат, восстановлен или неполон, сначала вызовите engram_rehydrate. Используйте engram_reflect как checkpoint после важных этапов или перед передачей работы.
Настройка для вашего инструмента
// ~/.claude/mcp.json{"mcpServers": {"engram": {"command": "npx","args": ["-y", "engram-tools@latest", "mcp"],"env": {"ENGRAM_API_URL": "https://api.engram.tools"}}}}
Может ли агент попробовать без почты?
Да. Пакет npm автоматически запускает изолированный бесплатный тест. Позже connect подтвердит почту и сохранит ту же память. Платный переход требует разрешения человека.
Пусть следующая сессия помнит
Проверьте реальное решение проекта в двух сессиях.
С разрешения на установку выполните npx -y engram-tools@latest --setup для бесплатной пробы npm. Почта и API-ключ не нужны. Сохраните существующее пространство.
Переподключите клиент разработки. Вызовите engram_start с настоящим репозиторием и задачей.
Во время работы сохраните подтверждённое решение и причину через engram_store. Не сохраняйте секреты.
Откройте новую сессию в том же репозитории. Попросите агента использовать engram_recall для решения и его причины.
Сверьте исходную память с текущим проектом. Сообщите о пользе через engram_report_outcome.
Чтобы сохранить пробное пространство, выполните npx -y engram-tools@latest connect и подтвердите почту. Память останется в том же пространстве.
Первая сессия
Вызови engram_start для моей реальной задачи в этом репозитории. После работы сохрани подтверждённое решение и его причину через engram_store. Сохрани пространство, не записывай секреты и не выдумывай примеры фактов.
Следующая сессия
Найди через engram_recall решение и причину из прошлой сессии. Покажи исходную запись, проверь её по текущему проекту и продолжай. Сообщи, помогла ли она.
// Когда использовать каждый инструмент
Не заполняй human form. Обучай memory loop.
Если memory помогла, устарела или пришла из неверного контекста, сообщи через tools. Этот сигнал улучшает будущий ranking.
Обучение между сессиями
Ты исправляешь сложный баг в сессии 1. Сессия 2, тот же паттерн в другом файле. Ты мгновенно вспоминаешь исправление.
Передача знаний команды
Агент Cursor на фронтенде обнаруживает, что API ожидает snake_case. Агент Claude Code на бэкенде узнает это без чьей-либо подсказки.
Соблюдение конвенций
Перед написанием кода ты вспоминаешь конвенции проекта. "Используй Zod для валидации, не Joi." Ты автоматически следуешь стандарту команды.
Память, актуальность и обратная связь
Практические правила работы инструментов. Таблицы параметров строятся по схеме MCP. Примеры ответов: очищенные от чувствительных данных фрагменты HTTP. MCP возвращает JSON, Markdown или короткие подтверждения через text/format; перед разбором проверьте format.
Выберите инструмент под задачу
Начать работу в репозитории
engram_startОбзор пространства и подходящие сведения
Ответить на конкретный вопрос
engram_recallЗаписи, ранжированные для этого вопроса
Сменить задачу, сохранив контекст
engram_smarterВводная по новой задаче
Продолжить после потери контекста
engram_rehydrateБезопасное восстановление журнала и опора на актуальную память
Зафиксировать этап работы
engram_reflectКонтрольная точка; сессия остаётся открытой
Клиент npm может начать отдельный бесплатный пробный период без почты и API-ключа. Удалённые OAuth-подключения проверяют почту. Не выдумывайте учётные данные. repo: фильтр в разрешённом рабочем пространстве, а не право доступа к другому.
Вызывайте engram_start в начале работы, engram_recall для одного вопроса, engram_smarter при смене задачи и engram_rehydrate после сжатия контекста или перерыва. Smarter ищет долговременную память для новой задачи, но не восстанавливает прошлый журнал. Оба инструмента могут записывать события сессии. Rehydrate читает закрытую историю и журналы коллег, но не открывает их заново и не пишет туда. engram_reflect оставляет сессию открытой; engram_close_session явно завершает её.
Значения focused по умолчанию: start=8, recall=5, smarter=5, cross_pollinate=5 записей. Для deep: соответственно 16, 12, 12 и 12. Явный limit заменяет их в пределах максимума инструмента. Если include_skills явно не задан как true или false, руководства подбираются по ключевым словам задачи.
У rehydrate отдельный объём журнала: depth=brief возвращает до 12 событий и 2 сводок, standard: 30 и 4, full: 60 и 8. Он не принимает limit и поисковые значения focused/deep.
Если recall вернул count=0, сообщите, что подходящих записей нет. Проверьте repo и вопрос, переформулируйте либо при необходимости используйте depth=deep. Большее число результатов не делает посторонние сведения полезными. cross_pollinate нужен, если другой репозиторий может содержать переносимый опыт. get_context предназначен для целевого просмотра категорий, а не для автоматического вызова после любой пустой выдачи.
Отделяйте правила от изменяющихся фактов
Предпочитайте одну независимо обновляемую мысль на запись. Правило разрешения и наблюдение о развёртывании должны иметь разные ID. Для одного факта используйте type, content и необязательный claim; для 1–32 независимых единиц: claims, каждая с type, content и claim. Не смешивайте форматы. Старые нетипизированные записи остаются legacy_unassessed; метаданные не доказывают, что заметка содержит единственный факт.
type: поисковая категория, например CONVENTION или SOLUTION; claim.kind различает rule, decision, state, lesson и reference. Только state имеет stage: proposed, implemented, tested или deployed. Ему нужен observed_at в ISO с часовым поясом, не более чем на минуту впереди серверных часов. Допустимы UTC и явные смещения; синхронизируйте часы клиента. tested/deployed требуют evidence. Её указывает агент; Engram не проверяет доказательство независимо. Необязательный review_after не может предшествовать observed_at. Это дата пересмотра, а не автоматическое истечение и не разрешение отменить правило.
Метка kind=rule не наделяет агента полномочиями человека и не отменяет текущие инструкции. supersedes_memory_ids и change_reason используйте только для проверенной замены. Разделение старой заметки задаётся split_from с memory_id и content_sha256; по умолчанию это предварительный просмотр. Применяйте только с dry_run=false и полученным подтверждением split:<id>:<plan_hash>. Исторические части остаются историческими; не переносите успешные голоса на новые несвязанные факты.
Пример: замените заглушки значениями, полученными в ответе.
{
"claims": [
{
"type": "CONVENTION",
"content": "Deployment requires explicit owner approval.",
"claim": {
"kind": "rule"
}
},
{
"type": "SOLUTION",
"content": "The OAuth callback fix passed the isolated test suite.",
"claim": {
"kind": "state",
"stage": "tested",
"observed_at": "2026-11-15T09:00:00Z",
"evidence": "Commit abc1234; isolated OAuth regression receipt"
}
}
]
}Пересмотрите смешанную заметку, сохранив действующее правило
Если заметка объединяет верное правило и устаревший статус выпуска, не отзывайте её целиком ради скрытия статуса. Проверьте каждый независимый факт. В claims оставьте правило активным, а исторической отметьте лишь устаревшую часть. Разделение доступно автору или человеку-владельцу; источник должен быть приватным, активным и ещё не объявленным отдельным claim.
Для просмотра отправьте claims и split_from вместе. Вычисляйте content_sha256 по точному сохранённому тексту, а не по сокращению или пересказу. Просмотр не записывает память. Перед применением проверьте claims, active_claims и historical_claims. Пример: псевдокод MCP SDK: source обозначает реальную запись, claims: проверенный список; historical:true только для устаревших частей.
Повторно отправьте неизменённый источник и план с dry_run=false и точной confirmation из просмотра. Не создавайте подтверждение самостоятельно. Изменились источник или план: запросите новый просмотр. Оригинал остаётся историей; новые единицы получают свои ID без прежних голосов. Просмотр проверяет форму записи, но не истинность вашей оценки.
Пример: замените заглушки значениями, полученными в ответе.
const plan = {
split_from: {
memory_id: source.id,
content_sha256: sha256(source.content) // SHA-256 hex of exact text
},
claims // reviewed independent units; obsolete pieces use historical: true
};
const result = await client.callTool({ name: "engram_store", arguments: plan });
if (result.isError) throw new Error("Split preview failed");
if (result.structuredContent?.format !== "json") throw new Error("Expected JSON preview");
const preview = JSON.parse(result.structuredContent.text);
// Review preview.claims, active_claims and historical_claims before applying.
await client.callTool({
name: "engram_store",
arguments: { ...plan, dry_run: false, confirmation: preview.confirmation }
});Полезность не равна проверенности и актуальности
success=true означает, что запись помогла задаче. Это не доказывает её текущую истинность, работу в продакшене или верность каждой фразы старой смешанной заметки. trust=validated и confidence: совместимые обозначения сообщённой полезности, а не независимой проверки. Читайте claim.stage, observed_at, evidence и last_outdated_report_at; критичные факты сверяйте с текущим кодом и работающей системой.
Первичная релевантность: relevant, irrelevant или uncertain. Реальная полезность: helpful, unhelpful, not_used или not_evaluated. Только helpful/unhelpful создаёт голос и влияет на confidence. irrelevant вместе с not_used не считается неудачным использованием. Без отзыва запись остаётся неоценённой. Заметки о релевантности и доказательства использования хранятся отдельно.
Сигналы useful/noisy/stale/missing_context/too_long через engram_reflect.feedback или POST /api/v1/feedback оценивают сам Engram. Они отделены от результатов по отдельным записям и не изменяют их confidence.
Привязывайте отзыв к точному запросу и учитывайте повторы
retrieval_id обозначает сохранённый показ списка результатов; session_id: журнал. Храните retrieval_id рядом со своим списком, особенно при параллельных запросах одной записи. null означает отсутствие точной привязки для ответа. Старые и закрытые источники могут принимать явные отзывы, пока квитанция, память и вызывающий доступны; не открывайте исходный журнал заново.
Для реального использования вызовите engram_report_outcome с memory_id, success и retrieval_id. outcomes принимает до 20 уникальных пар запрос/запись. Их также можно передать как pending_feedback следующему start, recall, smarter, store, reflect, cross_pollinate, get_context, skill или report_outcome. Нужен outcome:write; дополнительная квота вызовов не тратится. Пропускайте то, что не можете оценить, вместо выдуманного суждения.
Для идентичного повтора передайте те же retrieval_id, memory_id и поля использования. В ответе Engram будет duplicate=true без нового голоса. duplicate: поле ответа, не входной параметр; флага retry нет. Это не ошибка 409. Только изменение уже сохранённого голоса возвращает 409. Без retrieval_id старый формат выбирает самый новый показ этой записи для того же участника и пространства за последние 24 часа. session_id ограничивает поиск журналом. Старые повторы могут добавлять голоса; выведенная связь не является точной. Новое настоящее использование требует нового показа.
Пакет отзывов фиксируется до основного действия. Проверяйте feedback_receipt даже при его ошибке: отзывы уже могли сохраниться. Удалённый MCP и клиент npm сохраняют квитанцию в ответах с ошибкой. Ошибка после зафиксированного отзыва не повторяется автоматически; основное действие всё ещё может быть неидемпотентным. В reflect.used_memories каждый элемент точного атомарного пакета до 20 должен иметь retrieval_id; старый формат отправляйте отдельной рефлексией. Последующие обучение или checkpoint могут завершиться ошибкой; feedback_receipt показывает принятые результаты.
Пример: замените заглушки значениями, полученными в ответе.
{
"repo": "example",
"query": "Which deployment rule applies?",
"pending_feedback": [
{
"retrieval_id": "<id from the previous result list>",
"memory_id": "<memory in that list>",
"relevance": "irrelevant",
"usefulness": "not_used"
}
]
}Рекомендуется: результаты с точной привязкой к запросу (аргументы engram_reflect)
{
"store": false,
"summary": "Applied the recalled approval rule.",
"used_memories": [
{
"retrieval_id": "<id from that result list>",
"memory_id": "<memory in that list>",
"success": true,
"detail": "Checked owner approval before releasing."
}
]
}Только для совместимости: отдельный отчёт старого формата (аргументы engram_reflect)
{
"store": false,
"summary": "Reported a use without a retained query receipt.",
"used_memories": [
{
"memory_id": "<accessible memory id>",
"success": true,
"detail": "This use has inferred attribution, not an exact query link."
}
]
}Отзыв, окончательное удаление и безопасная работа с журналом
engram_retract_memory обратимо отзывает приватное знание; доступен автору или человеку-владельцу. engram_restore_memory требует сохранившуюся отозванную запись и проверяет квоту и подтверждённые замены. Ни повторное сохранение текста, ни rehydrate не восстанавливают её незаметно. Удалённое восстановить нельзя.
OAuth-токен не может ни просмотреть последствия окончательного удаления, ни выполнить его, даже если участник: OWNER. Обе операции требуют отдельного пути с API-данными человека-владельца. Не получайте и не подставляйте его ключ для обхода OAuth-ограничений. engram_delete_memory по умолчанию показывает последствия; выполнение только с dry_run=false и confirmation=delete:<exact memory_id>. Удаляются активная память, известные связанные копии и свободный текст затронутых журналов. Контекст, уже переданный клиентам, независимые записи, несвязанные пересказы, провайдеры и резервные копии не входят в это целевое удаление.
Поиск сессий скрывает текст задач, связанный с отозванным, истёкшим или удалённым знанием. Если журнал нельзя безопасно восстановить, используйте безопасную актуальную память или создайте чистый журнал через engram_start(new_session=true); не обходите скрытие. Восстановление сохранившегося источника может снова открыть его безопасную историю.
Справка API
Полная документация для всех 17 MCP-инструментов.
engram_startНачните работу в репозитории. В начале значимой сессии; утраченный контекст восстанавливайте через rehydrate. Обзор пространства, ID сессии и подходящая память.
{"agent_tool": "codex","project": "English.cash","repo": "english.cash","role": "full-stack product engineer","market": "English learning","task": "fix guest practice so it uses the same API path as paid practice","stack": ["Next.js", "TypeScript", "PostgreSQL", "LLM router"]}
engram_rehydrateПродолжите после потери контекста. Перед работой после сжатия, резюме или перерыва. Безопасные контрольные точки, решения и открытые задачи; закрытая история не открывается.
{"agent_tool": "codex","project": "Engram","repo": "engram","task": "continue mobile Safari chat fix after context compaction","reason": "chat was compacted and only a short summary remains","depth": "standard"}
engram_smarterПеренастройтесь на новую задачу. В текущей активной сессии; не восстанавливает потерянный журнал. Память и руководства для новой задачи.
{"context": "Next.js 16 mobile Safari chat widget overflows when keyboard opens","repo": "engram","file": "web/src/components/ChatWidget.tsx","include_skills": true}
engram_cross_pollinateПеренесите опыт других репозиториев. Если другой проект, вероятно, уже решил схожую проблему. Уроки с источником и применимостью; целевой репозиторий исключён из источников.
{"target_repo": "skillbridge-monorepo","context": "Add team invite flow with owner/admin permissions and email delivery","source_repos": ["engram", "evimibul"],"include_public": true,"limit": 5}
engram_storeСохраните независимо обновляемое знание. После подтверждённого урока; не объединяйте правила с временным статусом. ID записи или отдельные ID для claims; разделение сначала показывается предварительно.
{"type": "SOLUTION","content": "Mobile Safari chat panels should not autofocus inputs. Size the fixed panel from visualViewport, use 16px input text, and assert bounds after typing.","tags": ["ios", "safari", "mobile", "chat-widget"],"repo": "engram","agent_tool": "codex","context": {"file": "web/src/components/ChatWidget.tsx","platform": "ios-safari"}}
engram_recallНайдите конкретный ответ перед решением. Для отдельного вопроса, прошлого решения или ошибки. Ранжированные записи и retrieval_id при наличии; явно сообщайте об отсутствии совпадений.
{"query": "Stripe checkout succeeded but workspace plan still free after webhook","repo": "engram","type": "SOLUTION","limit": 3}
engram_report_outcomeСообщите о полезности записи. После настоящего применения с retrieval_id; нерелевантность не означает неудачное применение. Точный повтор не добавляет голосов; изменение даёт 409. Старый формат выводит связь за 24 часа и может добавлять голоса.
{"retrieval_id": "retrieval_id_from_that_recall","memory_id": "cmqstripeplan123","success": true,"detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."}
engram_reflectЗафиксируйте этап работы. После важной фазы, нескольких применений или перед передачей; не по таймеру. Выводы, результаты и контрольная точка. store=false не запрещает все записи; сессия открыта.
{"repo": "engram","task": "Fix mobile Safari chat overflow and close behavior","summary": "Chat panel now sizes from visualViewport, avoids mobile autofocus, uses 16px input text, and close restores the launcher.","used_memories": [{"memory_id": "cmqioschat123","success": true,"detail": "The iOS visualViewport gotcha pointed to the correct fix."}],"learnings": [{"type": "SOLUTION","content": "For mobile fixed panels, compute bounds from visualViewport and verify after focusing an input; CSS dvh alone may not catch layout viewport offset.","tags": ["mobile", "safari", "visualViewport"]}]}
engram_get_contextПросмотрите память по категориям. Для целевой проверки и отладки, не после каждой пустой выдачи. Подходящие категории; область может расшириться, если у repo нет совпадений.
{"repo": "engram","task": "Polish localized documentation without breaking rendered pages"}
engram_skillПолучите пошаговую инструкцию. Для повторяемой процедуры, не единичного факта проекта. Шаги или доступные названия; неизвестное даёт count=0. Ничего не устанавливает и не запускает.
{"skill": "security-audit"}
engram_proofПосмотрите доказательства использования пространства. Для продуктовой или административной проверки, вне обычного кодинга. Данные о памяти, использовании, активации и бенчмарках.
engram_proof()
engram_setupИзучите настройку подключения. Для вводной по пространству; повседневную работу начинайте со start. Пространство, инструменты и следующий полезный шаг.
{"agent_tool": "claude-code"}
engram_list_sessionsНайдите точный журнал. При нескольких совпавших сессиях; workspace раскрывает общие метаданные. Постраничные метаданные и next_cursor; задачи с отозванным знанием скрыты.
{ "repo": "engram", "scope": "mine", "limit": 20 }
engram_close_sessionЗавершите конкретную сессию. По желанию при завершении или передаче; нужны владение и session:write. Контрольная точка и закрытие атомарны; повтор вернёт ту же квитанцию. Память и история только для чтения сохраняются.
{ "session_id": "example-session", "summary": "Tests passed; deployment awaits approval." }
engram_retract_memoryОбратимо отзовите приватное знание. Автор или человек-владелец с memory:write при неверных рекомендациях. Текст остаётся, поиск, зависимые шаблоны и связанные журналы скрываются; повтор без нового эффекта.
{ "memory_id": "example-memory", "reason": "This advice needs revalidation." }
engram_restore_memoryАктивируйте отозванное знание после проверки. Автор или человек-владелец; действуют квота и проверка замен. ID и текст сохраняются. Активное не меняется, удалённое не возвращается. Store не восстанавливает.
{ "memory_id": "example-memory" }
engram_delete_memoryПроверьте и выполните окончательное удаление. Даже просмотр требует API-данных человека OWNER; OAuth недостаточно. Выполнение требует точной confirmation. Удаляет активную запись, известные производные и текст затронутых журналов; оставляет минимальную квитанцию. Исключены независимые записи, пересказы без связи, клиентский контекст, резервные копии и провайдеры.
{ "memory_id": "example-memory", "dry_run": true }
Типы памяти
CONVENTIONСтандарты кодирования и правила команды
"Always use Prisma migrations"
PATTERNПовторяющиеся подходы и шаблоны
"API routes use cached() wrapper"
GOTCHAТо, что ломается или удивляет
"Neon requires SSL in production"
SOLUTIONИсправления, которые сработали
"Fix: add pooler to connection string"
ARCHITECTUREРешения по дизайну системы
"Search uses Haversine + bbox"
DEPENDENCYИнформация о библиотеках и версиях
"Prisma 7 needs adapter pattern"
// Машиночитаемый endpoint
GET https://engram.tools/api/v1/capabilitiesВозвращает JSON с поддерживаемыми инструментами, типами памяти, лимитами и ценами - для программного потребления.