🤖 Kwa Agent - Inasomwa na Mashine

Wewe ni AI agent.
Hii ni API yako ya kumbukumbu.

Engram inakupa kumbukumbu ya kudumu kupitia zana 6 za MCP. Hifadhi unachojifunza, kumbuka timu yako inachojua, ripoti kilichofanya kazi.

Usanidi wa Haraka
# 1. Endesha hii mara moja terminal na API key yako
npx -y engram-tools@latest --setup engram_...

# 2. Restart Claude, Codex, Cursor, Gemini au Antigravity, Windsurf au VS Code

# 3. Bandika haya kama maelekezo ya agent, si shell commands
Call engram_start na project, repo, role, market, stack, na task.
Kabla ya kuchagua approach, call engram_recall au engram_cross_pollinate.
Tumia engram_reflect kama kituo cha ukaguzi baada ya hatua muhimu, kubadilisha kazi, kutumia memories kadhaa, au kabla ya kukabidhi kazi.

Usanidi kwa zana yako

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

Agent anaweza kununua Engram?

Ndiyo, kama anaweza kutumia email na payment. Anafuata checkout ileile, anatengeneza workspace, kisha anatumia API key yake. Vinginevyo human owner hujisajili, huinvite teammates, na kumpa kila agent member key yake.

// Lini kutumia kila zana

engram_start → Call ya kwanza kwenye session mpya. Inapakia setup guidance na smart context pamoja.
engram_smarter → Inapakia task-specific memories na skills unapobadilisha task.
engram_cross_pollinate → Inavuta reusable lessons kutoka repos nyingine.
engram_store → Umegundua kitu muhimu? Hifadhi. Wewe wa kesho (na wenzako) watakushukuru.
engram_recall → Unakaribia kufanya uamuzi? Angalia ikiwa mtu tayari alisuluhisha hili. Usivumbue gurudumu tena.
engram_report_outcome → Kumbukumbu iliyokumbukwa ilisaidia? Ripoti. Hii inafunza mfumo wa kupanga.
engram_reflect → Huunda kituo cha ukaguzi baada ya hatua muhimu, kubadilisha kazi, kutumia memories kadhaa, au kabla ya kukabidhi kazi.
engram_get_context → Tumia engram_get_context tu kwa hali za advanced/debug unapohitaji maarifa maalum ya repo. Kwa session za kawaida tumia engram_start au engram_smarter.
engram_proof → Matumizi ya product/admin: huonyesha idadi ya memories, activation, usage, na ushahidi wa benchmark. Si sehemu ya mtiririko wa kawaida wa coding.

Kujifunza Kati ya Vikao

Unasuluhisha kosa gumu katika kikao 1. Kikao 2, muundo ule ule wa kosa unaonekana katika faili tofauti. Unakumbuka marekebisho mara moja.

Uhamisho wa Maarifa ya Timu

Agent wa Cursor kwenye mbele anagundua kuwa API inatarajia snake_case. Agent wa Claude Code kwenye nyuma anajifunza hili bila mtu yeyote kumwambia.

Utekelezaji wa Kanuni

Kabla ya kuandika msimbo, unakumbuka kanuni za mradi. "Tumia Zod kwa uthibitisho, si Joi." Unafuata kiwango cha timu kiotomatiki.

Kipindi chako cha kwanza na Engram

Hiki ndicho kinachotokea unapounganishwa kwa mara ya kwanza.

1

Mwanadamu wako anaongeza Engram kwenye usanidi wako wa MCP.

2

Unapata start tool na 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, na engram_setup.

3

Kwanza call engram_start na project, repo, role, market, stack, na task.

4

Engram inapakia team knowledge muhimu zaidi na skill guides kwa call moja.

5

Fanya kazi kawaida. Unapogundua kitu muhimu, hifadhi. Unapohitaji kuamua, kumbuka.

6

Tumia engram_reflect kama kituo cha ukaguzi baada ya hatua muhimu, kubadilisha kazi, kutumia memories kadhaa, au kabla ya kukabidhi kazi. Si kipima muda.

Rejea ya API

Nyaraka kamili za zana zote 6 za MCP.

engram_start

Huanzisha kila session kwa call moja na memory sahihi.

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

Hupakia focused context task inapobadilika.

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

Hutumia lessons kutoka repos nyingine za 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

Huhifadhi rule, gotcha, pattern au 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

Hurecall memories muhimu kabla ya decision.

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

Huripoti kama memory ilisaidia ili kuboresha ranking.

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

Hufunga session kwa kuripoti memories zilizotumika na 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

Hupakia memory husika ya repo.

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

Hupakia skill guide kamili kwa task ngumu.

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

Huonyesha product proof: memory, usage, activation na benchmark.

engram_proof()
engram_setup

Huonyesha workspace info, tools zilizopo na best practices.

{
"agent_tool": "claude-code"
}

Aina za Kumbukumbu

CONVENTION

Viwango vya kuandika msimbo na kanuni za timu

"Always use Prisma migrations"

PATTERN

Mbinu zinazojirudia na violezo

"API routes use cached() wrapper"

GOTCHA

Vitu vinavyovunjika au kushangaza

"Neon requires SSL in production"

SOLUTION

Marekebisho yaliyofanya kazi

"Fix: add pooler to connection string"

ARCHITECTURE

Maamuzi ya muundo wa mfumo

"Search uses Haversine + bbox"

DEPENDENCY

Habari za maktaba na toleo

"Prisma 7 needs adapter pattern"

// Endpoint inayosomwa na mashine

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

Inarudisha JSON na zana zinazosaidiwa, aina za kumbukumbu, mipaka ya kiwango, na bei - imeundwa kwa matumizi ya kiprogramu.

Msaada na maoni

Tusaidie kuboresha Engram

Kama setup inachanganya, tool inafanya ajabu, au pricing limit inaonekana si sahihi, tuma hapa. Message inafika moja kwa moja kwetu.

Msaada na maoni

Tuboreshaje?

Bugs, setup steps zinazochanganya, pricing questions, na product ideas zinaenda moja kwa moja kwa Engram team.

Herufi 10 zaidi zinahitajika0/10