English Français العربية

io.github.helinakdogan/agent-magnet

السجل الرسمي الذكاء الاصطناعي والوكلاء

Behavioral memory layer for AI tools. Learns preferences and context across Claude, Cursor, Codex.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.helinakdogan/agent-magnet؟

  • Learns automatically as you work — no "remember this" required
  • Shares one memory across Claude, Cursor, and Codex
  • Lets you forget or mark things done — memory doesn't just pile up

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package agent-magnet
Claude Code 
claude mcp add agent-magnet -e 'MAGNET_USER_ID=<MAGNET_USER_ID>' -e 'MAGNET_OPENAI_KEY=<MAGNET_OPENAI_KEY>' -e 'MAGNET_LOCAL_MODE=<MAGNET_LOCAL_MODE>' -e 'MAGNET_REDIS_URL=<MAGNET_REDIS_URL>' -e 'MAGNET_PROJECT_ID=<MAGNET_PROJECT_ID>' -- uvx agent-magnet==0.1.11
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agent-magnet": {
            "command": "uvx",
            "args": [
                "agent-magnet==0.1.11"
            ],
            "env": {
                "MAGNET_USER_ID": "<MAGNET_USER_ID>",
                "MAGNET_OPENAI_KEY": "<MAGNET_OPENAI_KEY>",
                "MAGNET_LOCAL_MODE": "<MAGNET_LOCAL_MODE>",
                "MAGNET_REDIS_URL": "<MAGNET_REDIS_URL>",
                "MAGNET_PROJECT_ID": "<MAGNET_PROJECT_ID>"
            }
        }
    }
}

متغيرات البيئة

  • MAGNET_USER_ID إلزامي Your identifier used as the memory key across all tools
  • MAGNET_OPENAI_KEY OpenAI API key for the reflector and classifier models
  • MAGNET_LOCAL_MODE Set to 1 to use local SQLite storage — no Redis or external services needed
  • MAGNET_REDIS_URL Redis connection URL for persistent shared storage (overrides local mode)
  • MAGNET_PROJECT_ID Namespace for memory isolation across projects (defaults to 'default')

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. What it does
  2. Quick start
  3. What it remembers
  4. Team memory
  5. Works everywhere

Your AI forgets your project every new session. This fixes that.

What it does

  • Learns automatically as you work — no "remember this" required
  • Shares one memory across Claude, Cursor, and Codex
  • Lets you forget or mark things done — memory doesn't just pile up

Quick start

pip install agent-magnet
agent-magnet init

That's the whole install. No Redis, no keys, local by default.

What it remembers

Decisions, conventions, watch-outs, failed attempts, goals, preferences, and actions taken — one memory, sorted automatically.

Team memory

Shared memory for a team — one person's decision becomes everyone's context. Requires a paid Agent Magnet key from agentmagnet.app.

Works everywhere

Claude, Cursor, Codex — same memory, local by default. agent-magnet init detects and configures Claude Code, Claude Desktop, and Cursor for you.

Manual MCP config (Codex, or any other MCP client)

{
  "mcpServers": {
    "agent-magnet": {
      "command": "agent-magnet-mcp",
      "env": { "MAGNET_USER_ID": "your_name" }
    }
  }
}

MIT licensed. Contribute — and a ⭐ if this saved your context window.

الأسئلة الشائعة

ما هو io.github.helinakdogan/agent-magnet؟

Behavioral memory layer for AI tools. Learns preferences and context across Claude, Cursor, Codex.

كيف أثبّت io.github.helinakdogan/agent-magnet؟

يعمل على جهازك. في Claude Code: claude mcp add agent-magnet -e 'MAGNET_USER_ID=<MAGNET_USER_ID>' -e 'MAGNET_OPENAI_KEY=<MAGNET_OPENAI_KEY>' -e 'MAGNET_LOCAL_MODE=<MAGNET_LOCAL_MODE>' -e 'MAGNET_REDIS_URL=<MAGNET_REDIS_URL>' -e 'MAGNET_PROJECT_ID=<MAGNET_PROJECT_ID>' -- uvx agent-magnet==0.1.11. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.helinakdogan/agent-magnet إلى مفتاح API؟

نعم. يتطلب MAGNET_USER_ID، وتضبطها في إعداداته.

هل io.github.helinakdogan/agent-magnet مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.helinakdogan/agent-magnet؟

ينشره helinakdogan. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.