PowerMem IDE Apps
June 23, 2026 · View on GitHub
First-party setup flows that connect PowerMem to AI clients and IDEs. Every path points at the same backend — no per-client schema rewrites.
Pick your setup path
| If you use… | Use this directory | One-line agent prompt |
|---|---|---|
| Cursor, VS Code, Windsurf, GitHub Copilot, Qoder | vscode-extension/ | Read and follow apps/vscode-extension/SETUP.md to setup PowerMem |
| Claude Desktop, Cline, Codex, OpenCode, Roo Code, Goose, or any other MCP client | mcp-client/ | Read and follow apps/mcp-client/SETUP.md to setup PowerMem |
| Claude Code (hook-based plugin) | claude-code-plugin/ | Read and follow apps/claude-code-plugin/SETUP.md to set up PowerMem memory for Claude Code. |
Codex and OpenCode belong under
mcp-client/, notvscode-extension/. The VS Code extension flow is for VS Code–compatible IDEs only.
For OpenClaw, use the separate memory-powermem plugin — see OpenClaw integration.
Contents
| Directory | Description |
|---|---|
| vscode-extension | VS Code extension and agent-guided setup for Cursor, VS Code, Windsurf, GitHub Copilot, and Qoder. Commands: Query memories, Add selection, Quick note, Link to AI tools, Setup, Dashboard. |
| mcp-client | Agent-guided setup for generic MCP clients (Claude Desktop, Cline, Codex, OpenCode, and others). Uses powermem-mcp directly; prefers SSE on port 8848. |
| claude-code-plugin | Claude Code plugin with HTTP mode by default (REST hooks; empty mcpServers). Optional MCP mode via config/mcp-mode.mcp.json. |
Quick start
-
Clone the repo and enter it:
git clone https://github.com/oceanbase/powermem cd powermem -
Copy
.env.exampleto.envand set your LLM provider, API key, and model (minimum required credentials). -
Open the AI agent window in your client and paste the one-line prompt from the table above.
Each setup guide is idempotent: re-running it reuses an existing healthy backend and updates the target client config instead of duplicating entries.
For manual installs, powermem[server] provides the runtime dependencies for
both the HTTP API server and MCP transports. Add seekdb (for example
powermem[server,seekdb]) when you want the default embedded seekdb
storage/embedder.
Backend strategy
All setup flows share the same backend priority:
- Reuse an existing healthy HTTP API server if one is already running:
curl -s -m 5 http://localhost:8848/api/v1/system/health - Start the HTTP API server when needed:
powermem-server --host 0.0.0.0 --port 8848 - Fall back to MCP-only only when HTTP is unavailable:
powermem-mcp sse 8848(or streamable HTTP / stdio when the target client requires it)
The mcp-client/ path uses powermem-mcp directly and prefers SSE on port 8848. The vscode-extension/ path prefers the HTTP API and links the current IDE/client first. The claude-code-plugin/ path defaults to HTTP hooks and optionally enables in-chat MCP tools.
Setup & uninstall guides
| Directory | Setup | Uninstall | Details |
|---|---|---|---|
vscode-extension/ | SETUP.md | UNINSTALL.md | README.md |
mcp-client/ | SETUP.md | UNINSTALL.md | — |
claude-code-plugin/ | SETUP.md | UNINSTALL.md | README.md |
Per-client manual guides
When you prefer to wire things by hand instead of using an agent:
| Client | Guide |
|---|---|
| VS Code | docs/integrations/vs_code.md |
| Cursor | docs/integrations/cursor.md |
| Windsurf | docs/integrations/windsurf.md |
| GitHub Copilot | docs/integrations/github_copilot.md |
| Qoder | docs/integrations/qoder.md |
| Claude Code | docs/integrations/claude_code.md |
| Cline | docs/integrations/cline.md |
| Codex | docs/integrations/codex.md |
| OpenCode | docs/integrations/opencode.md |
| Any MCP client | docs/integrations/mcp_client.md |
| OpenClaw | docs/integrations/openclaw.md |
Full ecosystem overview: docs/integrations/overview.md.