🤖 Agent向け - 機械可読

あなたはAI Agent。
これはあなたのメモリAPI。

Engramは6つのMCPツールを通じて永続メモリを提供します。学んだことを保存し、チームの知識を想起し、結果を報告してください。

クイックセットアップ
# 1. API key 付きでターミナルで一度実行
npx -y engram-tools@latest --setup engram_...

# 2. Claude、Codex、Cursor、Gemini、Antigravity、Windsurf、VS Code を再起動

# 3. shell コマンドではなく agent への指示として貼り付け
project、repo、role、market、stack、task で engram_start を呼び出します。
方針を選ぶ前に engram_recall または engram_cross_pollinate を呼び出します。
重要な段階後、タスク切替時、複数の memory を使った後、引き継ぎ前に engram_reflect をチェックポイントとして使う。

ツール別セットアップ

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}
エージェントのアクセス

Agent は Engram を購入できますか？

はい。メールと支払いを扱える agent なら同じ checkout を進み、workspace を作成して API key を使えます。そうでない場合は人間の owner が登録し、メンバーを招待して各 agent に member key を渡します。

料金を見る人間向け設定手順

// 各ツールの使用タイミング

engram_start → 新しい session の最初の呼び出し。setup guidance と smart context をまとめて読み込みます。
engram_smarter → タスク変更時に task-specific memories と skills を読み込みます。
engram_cross_pollinate → 他の repos から再利用できる lessons を取得します。
engram_store → 有用なものを発見した?保存しよう。将来の自分(とチームメイト)が感謝する。
engram_recall → 決断しようとしている?誰かが既に解決したか確認。車輪の再発明はしない。
engram_report_outcome → 思い出したメモリが役立った?報告しよう。ランキングシステムのトレーニングになる。
engram_reflect → 重要な段階後、タスク切替時、複数の memory を使った後、引き継ぎ前にチェックポイントを作ります。
engram_get_context → engram_get_context は高度/debug 用途で、repo の知識ダンプが必要な場合だけ使います。通常のセッションでは engram_start または engram_smarter を使います。
engram_proof → Product/admin 用途: memory 数、activation、usage、benchmark 用の証拠を表示します。通常の coding flow では使いません。

セッション横断学習

セッション1で厄介なバグを修正。セッション2で同じバグパターンが別ファイルに。即座に修正を思い出す。

チーム知識移転

フロントエンドのCursor AgentがAPIがsnake_caseを期待していることを発見。バックエンドのClaude Code Agentが誰にも言われずにそれを学ぶ。

規約の適用

コードを書く前にプロジェクト規約を思い出す。"バリデーションにはZodを使い、Joiではない。"チーム標準を自動的に守る。

Engramとの初回セッション

初めて接続する時に何が起こるかをお伝えします。

1

あなたの人間がEngramをMCP設定に追加します。

2

開始ツールとメモリーツールを受け取ります: 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。

3

まず project、repo、role、market、stack、task を指定して engram_start を呼び出します。

4

Engram は最も関連するチーム知識とスキルガイドを1回の呼び出しで読み込みます。

5

通常通り作業してください。重要なことを発見したら保存。決定が必要な時は想起。

6

engram_reflect はタイマーではなく、重要な段階後、タスク切替時、複数の memory を使った後、引き継ぎ前のチェックポイントとして使います。

APIリファレンス

6つのMCPツールすべての完全なドキュメント。

engram_start

各 session を適切な memory と一緒に 1 回の呼び出しで開始します。

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

task が変わったときに focused context を読み込みます。

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

workspace 内の他 repo の知見を再利用します。

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

rule、gotcha、pattern、solution を保存します。

{
  "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 を recall します。

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

session 終了時に使用 memory と 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

repo の関連 memory を読み込みます。

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

複雑な task 用の完整な skill guide を読み込みます。

{
  "skill": "security-audit"
}
engram_proof

memory、usage、activation、benchmark の product proof を表示します。

engram_proof()
engram_setup

workspace info、available 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"

// 機械可読エンドポイント

GET https://engram.tools/api/v1/capabilities

サポートされるツール、メモリタイプ、レート制限、料金を含むJSONを返す - プログラマティック消費向け。

サポートとフィードバック

Engram の改善に協力する

setup が分かりにくい、tool の挙動がおかしい、pricing limit が違うと感じる場合はここに送ってください。メッセージは直接届きます。

サポートとフィードバック

何を改善しますか？

Bugs、分かりにくい setup steps、pricing questions、product ideas は Engram team に直接届きます。

あと 10 文字必要です0/10