🤖 Ku ba Agent - Isomwa n'Imashini

Uri AI agent.
Iyi ni API yawe y'ububiko.

Engram iguha ububiko buhoraho ukoresheje ibikoresho 6 bya MCP. Bika icyo wize, wibuke ikipe yawe izi, raporo ku bikorwa.

Gutegura Byihuse
# 1. Bikoreshe rimwe muri terminal ukoresheje API key yawe
npx -y engram-tools@latest --setup engram_...

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

# 3. Bishyiremo nk’amabwiriza ya agent, si shell commands
Call engram_start hamwe na project, repo, role, market, stack, na task.
Mbere yo guhitamo approach, call engram_recall cyangwa engram_cross_pollinate.
Koresha engram_reflect nka checkpoint nyuma y’icyiciro gikomeye, mbere yo guhindura task, nyuma yo gukoresha memories nyinshi, cyangwa mbere yo guhererekanya akazi.

Gutegura ku gikoresho cyawe

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

Agent ishobora kugura Engram?

Yego, niba ishobora gukoresha email na payment. Ica muri checkout imwe, igakora workspace, hanyuma ikoresha API key yayo. Bitari ibyo human owner yiyandikisha, agatumira teammates, agaha buri agent member key yayo.

Fungura pricingInzira ya setup y'umuntu

// Ryari ukoresha buri gikoresho

engram_start → Call ya mbere muri session nshya. Ipakiwa setup guidance na smart context hamwe.
engram_smarter → Ipakiwa task-specific memories na skills iyo uhinduye task.
engram_cross_pollinate → Ikura reusable lessons mu zindi repos.
engram_store → Wavumbuye ikintu gifasha? Kibike. Wowe w'ejo (n'abagize itsinda) bazagushimira.
engram_recall → Ugiye gufata icyemezo? Reba niba hari umuntu wabikosoye. Ntusubire gukora ibisanzwe.
engram_report_outcome → Ububiko bwibukijwe bwaba bwarafashije? Menyesha. Ibi bitoza uburyo bwo gutondeka.
engram_reflect → Ikora checkpoint nyuma y’icyiciro gikomeye, mbere yo guhindura task, nyuma yo gukoresha memories nyinshi, cyangwa mbere yo guhererekanya akazi.
engram_get_context → Koresha engram_get_context gusa muri advanced/debug igihe hakenewe repo knowledge dump yihariye. Muri session zisanzwe koresha engram_start cyangwa engram_smarter.
engram_proof → Ikoreshwa rya product/admin: yerekana memory counts, activation, usage, na benchmark proof. Si igice cya coding flow isanzwe.

Kwiga Hagati y'Inama

Ukosora ikosa rikomeye mu nama ya 1. Nama ya 2, ishusho y'ikosa rimwe igaragara mu dosiye itandukanye. Wibuka igikosora ako kanya.

Kohereza Ubumenyi bw'Itsinda

Agent wa Cursor ku mbere avumbura ko API itegereje snake_case. Agent wa Claude Code ku nyuma abiga nta muntu ubimubwiye.

Gushyira mu Bikorwa Amategeko

Mbere yo kwandika kode, wibuka amategeko y'umushinga. "Koresha Zod ku kugenzura, atari Joi." Ukurikiza ubuziranenge bw'itsinda mu buryo bwikora.

Inama yawe ya mbere na Engram

Ibi nibyo bibera igihe uhuzwa ku nshuro ya mbere.

1

Umuntu wawe yongeraho Engram kuri MCP config yawe.

2

Uhabwa 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

Banza call engram_start hamwe na project, repo, role, market, stack, na task.

4

Engram ipakira team knowledge ikenewe cyane na skill guides muri call imwe.

5

Kora nk'uko bisanzwe. Iyo uvumbuye ikintu cy'ingenzi, kibike. Iyo ukeneye gufata icyemezo, ibuka.

6

Koresha engram_reflect nka checkpoint nyuma y’icyiciro gikomeye, mbere yo guhindura task, nyuma yo gukoresha memories nyinshi, cyangwa mbere yo guhererekanya akazi. Si timer.

API Referansi

Inyandiko yuzuye y'ibikoresho byose 6 bya MCP.

engram_start

Itangira buri session muri call imwe hamwe na memory ikwiye.

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

Ipakira focused context task ihindutse.

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

Ikoresha lessons zivuye mu zindi repos 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

Ibika rule, gotcha, pattern cyangwa 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

Igarura memories zingirakamaro mbere ya decision.

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

Itanga report niba memory yafashije kugira ranking ibe nziza.

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

Isoza session itanga report ya memories zakoreshejwe 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

Ipakira memory ijyanye na repo.

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

Ipakira skill guide yuzuye kuri task ikomeye.

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

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

engram_proof()
engram_setup

Yerekana workspace info, tools zihari na best practices.

{
  "agent_tool": "claude-code"
}

Ubwoko bw'Ububiko

CONVENTION

Ubuziranenge bwo gukora kode n'amategeko y'itsinda

"Always use Prisma migrations"

PATTERN

Uburyo bugaruka n'inzitizi

"API routes use cached() wrapper"

GOTCHA

Ibintu bimena cyangwa bitangaza

"Neon requires SSL in production"

SOLUTION

Ibikosoro byakoze

"Fix: add pooler to connection string"

ARCHITECTURE

Ibyemezo by'imiterere y'sisitemu

"Search uses Haversine + bbox"

DEPENDENCY

Amakuru y'isomero n'inverisiyo

"Prisma 7 needs adapter pattern"

// Endpoint isomwa n'imashini

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

Isubiza JSON hamwe n'ibikoresho bishyigikiwe, ubwoko bw'ububiko, imbago z'umuvuduko, n'ibiciro - byakozwe kugira ngo bikoreshwe mu buryo bwa porogaramu.

Ubufasha n’ibitekerezo

Dufashe kunoza Engram

Niba setup iteye urujijo, tool ikora bidasanzwe, cyangwa pricing limit isa n’itari yo, andika hano. Message ihita itugeraho.

Ubufasha n’ibitekerezo

Duteze imbere iki?

Bugs, setup steps ziteye urujijo, pricing questions, na product ideas bihita bigera kuri Engram team.

Hasigaye inyuguti 100/10