🤖 Agent向け - 機械可読

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

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

クイックセットアップ
# 1. メールも API キーも不要で無料体験
npx -y engram-tools@latest --setup

# 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 を呼び出します。
context が圧縮、再開、または不足している場合は、続行前に 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 でメールを認証すると同じ記憶を引き継げます。有料アップグレードには人の承認が必要です。

次のセッションにも記憶をつなぐ

実際のプロジェクト判断を二つのセッションで試します。

1

インストールの許可を得て npx -y engram-tools@latest --setup を実行します。npm の無料試用はメール・API キー不要です。既存ワークスペースを保ちます。

2

開発クライアントを再接続し、実際のリポジトリと作業で engram_start を呼びます。

3

作業中に、確認済みの判断と理由を engram_store で保存します。秘密は保存しません。

4

同じリポジトリで新しいセッションを開き、engram_recall で判断と理由を見つけるよう頼みます。

5

元の記憶を現在のプロジェクトで確認し、engram_report_outcome で役立ったかを報告します。

6

試用ワークスペースを残す際は npx -y engram-tools@latest connect でメールを認証します。記憶は同じ場所に残ります。

最初のセッション

このリポジトリの実際の作業について engram_start を呼んでください。作業後、確認済みの判断と理由を engram_store で保存してください。既存のワークスペースを維持し、秘密や架空のデモ用事実は保存しないでください。

次のセッション

前のセッションの判断と理由を engram_recall で探してください。元の記憶を示し、現在のプロジェクトで確認してから作業を続け、役立ったかを報告してください。

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

engram_start → 新しい session の最初の呼び出し。setup guidance と smart context をまとめて読み込みます。
engram_rehydrate → context compaction、要約、再開、履歴不足の後に呼びます。最新 checkpoint、決定、open loops、gotchas、最近の学びを復元します。
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 では使いません。
Agent feedback protocol

人間向けフォームではなく、memory loop を鍛える。

memory が役立った、古い、または wrong context だった場合は tools で報告します。この signal が future ranking を改善します。

01recalled memory を使った後、engram_report_outcome を success true/false で呼びます。
02複数 memory が作業に影響したら engram_reflect で checkpoint を作ります。
03他 repo が pattern を解決済みかもしれない場合、planning 前に engram_cross_pollinate を呼びます。

セッション横断学習

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

チーム知識移転

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

規約の適用

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

記憶、鮮度、フィードバック

各ツールの実際の動作を説明します。パラメータ表は MCP スキーマから生成されます。応答例は機密情報を除いた HTTP 応答の抜粋です。MCP は text/format を通じて JSON、Markdown、短い確認メッセージを返すため、解析前に 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 は意図的なカテゴリ別調査用で、空の検索結果の後に毎回呼ぶものではありません。

規則と変わり得る事実を分ける

記憶 1 件につき、独立して保守できる事実 1 つを基本にしてください。承認ルールとデプロイ状態の観測には別の ID が必要です。単体では type、content、任意の claim を使い、1–32 件の独立した単位は各要素に type、content、claim を持つ claims で送ります。両形式を混ぜないでください。未分類の古い記憶は legacy_unassessed のままです。メタデータを付けても、事実が 1 つしかない証明にはなりません。

type は CONVENTION、SOLUTION などの検索カテゴリ、claim.kind は rule、decision、state、lesson、reference という性質を示します。stage を持つのは state のみで、proposed、implemented、tested、deployed を指定します。タイムゾーン付き ISO 形式の observed_at が必須で、サーバー時刻より 1 分を超えて先にはできません。UTC と明示的な時差を利用でき、クライアントの時計を同期してください。tested/deployed は evidence も必要です。証拠はエージェントの申告で、Engram が独立検証するものではありません。任意の review_after は observed_at より前にできず、再確認日を示します。自動失効日でもルール撤回の許可でもありません。

kind=rule は人間の権限を与えず、現在の指示を上書きしません。supersedes_memory_ids と change_reason は確認済みの置き換えだけに使います。古い記憶の分割は memory_id と content_sha256 を持つ split_from で行い、既定ではプレビューです。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"
      }
    }
  ]
}
混在した古い記憶を、有効な規則を失わずに見直す

有効な承認ルールと古いリリース状態が同じ記憶にある場合、状態を隠すためだけに全体を撤回しないでください。独立した事実を 1 つずつ確認します。提案する 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 です。票を作り confidence に影響するのは helpful/unhelpful だけです。irrelevant かつ not_used でも使用失敗票は作りません。フィードバックがなければ未評価のままです。関連性のメモと実利用の証拠は別々に保持します。

engram_reflect.feedback または POST /api/v1/feedback の useful/noisy/stale/missing_context/too_long は、Engram 製品自体の評価です。個別の記憶の使用結果とは別で、その confidence を変えません。

正確な検索に紐づけ、再送を安全に扱う

retrieval_id は記録された結果一覧の提示を、session_id は日誌を識別します。同じ記憶が並行検索に出る場合も、retrieval_id を対応する一覧と保持してください。null なら、その応答には正確な紐づけがありません。受領記録、記憶、呼び出し元へのアクセスが保たれていれば、古い検索や終了済み履歴にも明示的なフィードバックを送れます。元のセッションは再開しません。

実際の利用 1 件には engram_report_outcome へ memory_id、success、retrieval_id を渡します。最大 20 の重複しない検索・記憶ペアには outcomes を使います。同じ項目を次の start、recall、smarter、store、reflect、cross_pollinate、get_context、skill、report_outcome の pending_feedback に付けることもできます。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 を付けて正確な原子的バッチにし、旧形式は別の reflect に分けます。後続の学習保存やチェックポイントが失敗しても、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 または claims ごとの ID。旧記憶の分割はまずプレビューです。

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

完全削除の影響を確認して実行します。 プレビューでも人間 OWNER の API 認証が必要で、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"

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

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

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

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

Engram の改善に協力する

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

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

何を改善しますか?

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

チームにフィードバックを送る前に、メールアドレスを確認してください。アカウントは作成されません。

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