By shaurgon
ConPort — project context & agent memory for Claude Code (MCP + skills + hooks).
npx claudepluginhub shaurgon/conport-plugin --plugin conportThis plugin requires configuration values that are prompted when the plugin is enabled. Sensitive values are stored in your system keychain.
api_keyConPort API key (cport_live_...). Get one from https://me.conport.app/dashboard/connect
${user_config.api_key}Use when managing agent identity, persistent memory, and project attachments in multi-agent systems. Must run agent_init at session start.
Use when managing project context - task planning, progress tracking, documentation, searching project information. Must run init at session start.
MCP integration + portable skills for ConPort — project context & agent memory. Packaged as a Claude Code plugin, but the MCP server and skills work across many clients.
conport — HTTP transport → https://api.conport.app/mcp/, Bearer auth. 40+ tools (decisions, tasks, patterns, documents, links, search, GraphRAG, agent memory).SKILL.md, portable)
conport — session context management (init, search, log_progress, sync_decision, …)conport-agent — persistent agent identity & memory (agent_init, agent_remember, agent_recall, …)SessionStart — fetches the deny-list (project conventions) from ConPortPreToolUse(Bash) — blocks commands matching deny-list patternsUserPromptSubmit — context restore + save reminder every 5 messagesSessionEnd — LLM-based reflection of unsaved decisionsPick your client:
| Client | Guide |
|---|---|
| Claude Code | docs/install/claude-code.md |
| Cursor | docs/install/cursor.md |
| Claude.ai (web) | docs/install/claude-ai.md |
| OpenClaw | docs/install/openclaw.md |
| mcporter (generic MCP host) | docs/install/mcporter.md |
| Paperclip | docs/install/paperclip.md (stub — verifying upstream) |
Onboarding an operator (e.g. an OpenClaw agent told to "add conport by instructions"): point them at INSTRUCTIONS.md.
Get an API key at me.conport.app/dashboard/connect — format is cport_live_....
| Variable | Where | Purpose |
|---|---|---|
user_config.api_key | Plugin userConfig (prompted on install) | Auth for MCP + hooks |
CONPORT_PROJECT_ID | .claude/settings.local.json env (optional) | Override numeric project id |
CONPORT_PROJECT_NAME | .claude/settings.local.json env (optional) | Override project name |
Fallback when neither override is set: basename(git remote) → current dir name.
${CLAUDE_PLUGIN_ROOT} — read-only plugin install (scripts, skills)${CLAUDE_PLUGIN_DATA} — persistent per-plugin storage
deny-list.json — cached conventionshook_state/conport_reminder.json — save-reminder countersession_logs/<session_id>_restored.flag — "context already restored" markerssession-end.log — reflection debug logconport entry from ~/.claude.json → mcpServers.~/.claude/settings.json.~/.claude/skills/conport and ~/.claude/skills/conport-agent.~/.claude/hooks/guardrails/ + user_prompt_submit.py + session-reflect.py.ConPort is solo-maintained — top-voted Ideas get reviewed monthly, and roadmap commitments are announced in the Announcements category.
Persistent memory system for Claude Code - seamlessly preserve context across sessions
Executes bash commands
Hook triggers when Bash tool is used
External network access
Connects to servers outside your machine
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Memory compression system for Claude Code - persist context across sessions
Search and retrieve documents from local markdown files.
Intelligent prompt optimization using skill-based architecture. Enriches vague prompts with research-based clarifying questions before Claude Code executes them