🤖 Для агентов - машиночитаемый

Ты AI-агент.
Это твой API памяти.

Engram дает тебе постоянную память через 11 MCP-инструментов. Сохраняй то, что узнаешь, загружай smart context, переноси lessons между репозиториями, доказывай usage и закрывай loop через reflection.

Быстрая настройка

# 1. Один раз выполните в терминале с API key
npx -y engram-tools@latest --setup engram_...

# 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_reflect как контрольную точку после важных этапов, смены задачи, нескольких использованных memories или перед передачей работы.

Настройка для вашего инструмента

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}

Доступ агента

Может ли агент купить Engram?

Да, если агент может пройти email и оплату. Он использует тот же checkout, создает workspace и работает со своим API key. Иначе human owner регистрируется, приглашает участников и выдает каждому агенту отдельный member key.

Открыть цены Настройка для человека

// Когда использовать каждый инструмент

engram_start → Первый вызов в каждой новой сессии. Загружает setup guidance и smart context вместе.

engram_smarter → Загружает task-specific memories и skills при смене задачи.

engram_cross_pollinate → Берет переиспользуемые lessons из других repos.

engram_store → Обнаружил что-то полезное? Сохрани. Будущий ты (и коллеги) скажут спасибо.

engram_recall → Собираешься принять решение? Проверь, решал ли кто-то это раньше. Не изобретай велосипед.

engram_report_outcome → Вспомненная память помогла? Сообщи. Это тренирует систему ранжирования.

engram_reflect → Создает контрольную точку после важных этапов, смены задачи, нескольких использованных memories или перед передачей работы.

engram_get_context → Используйте engram_get_context только для продвинутых/debug случаев, когда нужен сфокусированный срез знаний репозитория. В обычных сессиях используйте engram_start или engram_smarter.

engram_proof → Продуктовый/admin сценарий: показывает объем memories, активацию, usage и benchmark-ready proof. Не часть обычного coding flow.

Обучение между сессиями

Ты исправляешь сложный баг в сессии 1. Сессия 2, тот же паттерн в другом файле. Ты мгновенно вспоминаешь исправление.

Передача знаний команды

Агент Cursor на фронтенде обнаруживает, что API ожидает snake_case. Агент Claude Code на бэкенде узнает это без чьей-либо подсказки.

Соблюдение конвенций

Перед написанием кода ты вспоминаешь конвенции проекта. "Используй Zod для валидации, не Joi." Ты автоматически следуешь стандарту команды.

Ваша первая сессия с Engram

Вот что происходит при первом подключении.

Ваш человек добавляет Engram в вашу MCP-конфигурацию.

Вы получаете стартовый инструмент и memory tools: engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context и engram_setup.

Сначала вызовите engram_start с project, repo, role, market, stack и task.

Engram загружает самые релевантные знания команды и skill guides одним вызовом.

Работайте как обычно. Когда обнаружите что-то важное, сохраните. Когда нужно решить, вспомните.

Используйте engram_reflect как контрольную точку после важных этапов, смены задачи, нескольких использованных memories или перед передачей работы. Это не таймер.

Справка API

Полная документация для всех 11 MCP-инструментов.

engram_start

Запускает каждую сессию одним вызовом с нужной memory.

{
  "agent_tool": "codex",
  "project": "HouseCompass",
  "repo": "housecompass.uk",
  "role": "frontend product engineer",
  "market": "UK property",
  "task": "build listing detail page",
  "stack": ["Next.js", "TypeScript", "PostgreSQL"]
}

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

Переиспользует уроки из других repo workspace.

{
  "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

Сохраняет правило, gotcha, pattern или решение.

{
  "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

Находит полезные memories перед решением.

{
  "query": "Stripe checkout succeeded but workspace plan still free after webhook",
  "repo": "engram",
  "type": "SOLUTION",
  "limit": 3
}

engram_report_outcome

Сообщает, помогла ли memory, и улучшает ranking.

{
  "memory_id": "cmqstripeplan123",
  "success": true,
  "detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."
}

engram_reflect

Закрывает сессию отчетом о memories и learnings.

{
  "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

Загружает релевантную memory для repo.

{
  "repo": "engram",
  "task": "Polish localized documentation without breaking rendered pages"
}

engram_skill

Загружает полный skill guide для сложной задачи.

{
  "skill": "security-audit"
}

engram_proof

Показывает product proof: memory, usage, activation и benchmark.

engram_proof()

engram_setup

Показывает workspace info, доступные tools и best practices.

{
  "agent_tool": "claude-code"
}

Типы памяти

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 с поддерживаемыми инструментами, типами памяти, лимитами и ценами - для программного потребления.

Ты AI-агент.
Это твой API памяти.

Настройка для вашего инструмента

Может ли агент купить Engram?

// Когда использовать каждый инструмент

Обучение между сессиями

Передача знаний команды

Соблюдение конвенций

Ваша первая сессия с Engram

Справка API

Типы памяти

Помогите нам улучшить Engram

Что улучшить?

Ты AI-агент.Это твой API памяти.

Настройка для вашего инструмента

Может ли агент купить Engram?

// Когда использовать каждый инструмент

Обучение между сессиями

Передача знаний команды

Соблюдение конвенций

Ваша первая сессия с Engram

Справка API

Типы памяти

Помогите нам улучшить Engram

Что улучшить?

Ты AI-агент.
Это твой API памяти.