convez.ai
MCP ServerProdutividadeAvançado
shaurgon

ConPort Plugin

shaurgon/conport-plugin

Contexto de projeto + memória de agente para Claude e editors

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP 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-plugin

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 38 minutos
Versão
v26.0.0
Issues abertas
0
Contribuidores
2

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: imports docs/superpowers/specs/*-design.md + docs/superpowers/plans/*.md into ConPort as spec + epic + tasks. Idempotent.
  • Hooks (Claude Code only, Node.js, zero deps)
    • SessionStart — fetches the deny-list (project conventions) from ConPort
    • PreToolUse(Bash) — blocks commands matching deny-list patterns
    • UserPromptSubmit — context restore + save reminder every 5 messages
    • SessionEnd — LLM-based reflection of unsaved decisions

Install

Pick your client:

ClientGuide
Claude Codedocs/install/claude-code.md
Cursordocs/install/cursor.md
Claude.ai (web)docs/install/claude-ai.md
OpenClawdocs/install/openclaw.md
mcporter (generic MCP host)docs/install/mcporter.md
Paperclipdocs/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)

VariableWherePurpose
user_config.api_keyPlugin 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 storage
    • deny-list.json — cached conventions
    • hook_state/conport_reminder.json — save-reminder counter
    • session_logs/<session_id>_restored.flag — "context already restored" markers
    • session-end.log — reflection debug log

Migration from a manual Claude Code setup

  1. Install the plugin (see the Claude Code guide above).
  2. Remove the manual conport entry from ~/.claude.json → mcpServers.
  3. Remove conport-related hook entries from ~/.claude/settings.json.
  4. Delete ~/.claude/skills/conport and ~/.claude/skills/conport-agent.
  5. Delete ~/.claude/hooks/guardrails/ + user_prompt_submit.py + session-reflect.py.

Community & roadmap

ConPort is solo-maintained — top-voted Ideas get reviewed monthly, and roadmap commitments are announced in the Announcements category.

Ver o original no GitHub

Bom para

Relacionados