ConPort Plugin
shaurgon/conport-plugin
Contexto de projeto + memória de agente para Claude e editors
Ver no GitHubMCP server que integra contexto de projeto e memória de agente para Claude Code e outros clientes. Fornece 40+ ferramentas para gerenciar decisões, tarefas, padrões, documentos e memória persistente de agentes através de skills portáveis e hooks inteligentes.
Instalação
npx convez-ai shaurgon/conport-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter contexto de projeto entre sessões do Claude Code
- Armazenar e recuperar decisões arquiteturais e padrões
- Integrar memory persistente para agentes autônomos
- Sincronizar specs de design com tarefas do projeto
- Implementar guardrails de convenção de projeto
Veredito

Ferramenta robusta para equipes que usam Claude Code ou Cursor e precisam de memória arquitetural persistente e contexto estruturado. Requer setup inicial mas oferece forte ROI em projetos complexos ou com múltiplos agentes.
README
A tradução para o português deste README ainda está na fila.
ConPort plugin
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.
What it ships
- MCP server
conport— HTTP transport →https://api.conport.app/mcp/, Bearer auth. 40+ tools (decisions, tasks, patterns, documents, links, search, GraphRAG, agent memory). - Skills (plain
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, …)superpowers-conport— bridge for Claude Code's superpowers plugin: importsdocs/superpowers/specs/*-design.md+docs/superpowers/plans/*.mdinto ConPort as spec + epic + tasks. Idempotent.
- Hooks (Claude Code only, Node.js, zero deps)
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 decisions
Install
Pick 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_....
Configuration (Claude Code)
| 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.
Paths (Claude Code hooks)
${CLAUDE_PLUGIN_ROOT}— read-only plugin install (scripts, skills)${CLAUDE_PLUGIN_DATA}— persistent per-plugin storagedeny-list.json— cached conventionshook_state/conport_reminder.json— save-reminder countersession_logs/<session_id>_restored.flag— "context already restored" markerssession-end.log— reflection debug log
Migration from a manual Claude Code setup
- Install the plugin (see the Claude Code guide above).
- Remove the manual
conportentry from~/.claude.json→mcpServers. - Remove conport-related hook entries from
~/.claude/settings.json. - Delete
~/.claude/skills/conportand~/.claude/skills/conport-agent. - Delete
~/.claude/hooks/guardrails/+user_prompt_submit.py+session-reflect.py.
Community & roadmap
- Discussions — feature ideas, Q&A, show-and-tell: github.com/shaurgon/conport-plugin/discussions
- Roadmap — priorities and scope: roadmap.md
- Pricing — free + two beta paid tiers: pricing.md
- Data handling — what we store, where, who sees it, how to export/delete: data-handling.md
- Bug reports — Issues
ConPort is solo-maintained — top-voted Ideas get reviewed monthly, and roadmap commitments are announced in the Announcements category.