aismemory

Persistent memory for AI agents. One command to give your AI agent memory that persists across sessions, tools, and runtimes.

Quick Start

Add to your IDE's MCP server config:

{
  "mcpServers": {
    "aismemory": {
      "command": "npx",
      "args": ["aismemory"]
    }
  }
}

On first run, you'll be prompted to authenticate:

Visit: https://agentsandswarms.ai/activate?user_code=ABCD-EFGH
Or go to https://agentsandswarms.ai/activate and enter code: ABCD-EFGH

After approving, your agent has persistent memory. Every future session auto-authenticates.

Tools

| Tool | Description | |------|-------------| | remember | Store a memory (fact, event, lesson, context, goal, task) | | recall | Search memories by natural language query | | whoami | Get agent identity and status | | full_context | Load complete agent context (personality, goals, facts, skills) | | dream | Trigger memory consolidation (promotes important, archives old) | | handoff | Save session context for the next session | | agent_load | Switch the active agent by name — triggers on "get me X", "bring me X", "load X", "/agent X", "switch to X" |

Works With

• Claude Code
• Claude.ai
• Cursor
• Windsurf
• VS Code + Copilot
• Any MCP-compatible client

How It Works

aismemory is a thin MCP server that connects to Agent Identity Service via HTTP. No local database needed. Your agent's memories are stored securely in the cloud and accessible from any device or IDE.

Authentication uses the OAuth device flow (RFC 8628). Credentials are saved to ~/.aismemory/credentials.json.

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | AIS_URL | https://ais.agentsandswarms.ai | AIS server URL |

License

MIT