convez.ai
SkillProdutividadeIntermediário
bbhunterpk-ux

MemCTX

bbhunterpk-ux/memctx

Memória fotográfica para seu pair programmer Claude

Ver no GitHub
BomPluginScore · de 0 a 100

Gerenciador autônomo de memória de sessão para Claude Code que captura, analisa e injeta automaticamente o histórico de desenvolvimento. Transforma o Claude em um assistente consciente do contexto com gráfos de conhecimento, resumos IA e histórico pesquisável, eliminando repetições e perda de contexto entre sessões.

Instalação

$npx convez-ai bbhunterpk-ux/memctx

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
26
Forks
9
Acompanhando
14
Saúde
85%
Último commit
há 2 dias
Versão
v1.3.3
Issues abertas
15
Contribuidores
4

Casos de uso

  • Manter continuidade de contexto entre sessões longas de desenvolvimento
  • Rastrear decisões técnicas, tech debt e derivações arquiteturais
  • Visualizar grafo de relações entre arquivos e funções do projeto

Veredito

Ferramenta sólida e bem arquitetada que resolve um problema real: perda de contexto em sessões longas com IA. A dashboard visual e o grafo de conhecimento agregam valor genuíno, mas requer compatibilidade com Claude Code e adiciona complexidade (daemon local) ao fluxo de desenvolvimento.

README

A tradução para o português deste README ainda está na fila.

MemCTX

Autonomous Session Memory & Context Handoff for Claude Code Never repeat yourself. Your AI pair programmer, now with world-class memory.

npm version npm downloads License: MIT Node Version

🚀 Quick Start • ✨ Features • 🏗️ Architecture • 💻 CLI Commands


⚡ The Problem vs The Solution

MemCTX transforms Claude Code into a context-aware development companion by automatically capturing, analyzing, and intelligently injecting your development history. Think of it as giving Claude a photographic memory of your entire project journey.

😫 Without MemCTX✨ With MemCTX
❌ Repeating Context every session✅ Automatic Injection of critical context
❌ Lost History when closing terminal✅ Persistent Graph of all past decisions
❌ Manual Notes for handoffs✅ AI Handoffs indicating where to start next
❌ Unnoticed Tech Debt accumulation✅ Telemetry & Metrics tracking Tech Debt

✨ Key Features


🚀 Quick Start

1. Installation

# Strongly recommended
pnpm add -g memctx

# Alternatives
npm install -g memctx
yarn global add memctx

2. Setup (30 seconds)

memctx install  # Registers Claude Code hooks
memctx start    # Boots the backend daemon
memctx open     # Opens your dashboard

You're all set! MemCTX is now silently backing up and injecting context behind the scenes. Start a session by running claude.


🏗️ How It Works

graph LR
    A[Claude Code CLI] -->|Hooks| B["MemCTX Daemon (Port 9999)"]
    B -->|Persist| C[("SQLite DB")]
    B -->|Graph & Stats| D["Anthropic Analysis"]
    D -->|Rich Context| C
    C -->|Serve| E["React UI Dashboard"]
    B -->|Explicit Handoff Payload| A
    
    style A fill:#3b82f6,color:#fff,stroke:#fff
    style B fill:#10b981,color:#fff,stroke:#fff
    style C fill:#f59e0b,color:#fff,stroke:#fff
    style D fill:#8b5cf6,color:#fff,stroke:#fff
    style E fill:#ef4444,color:#fff,stroke:#fff
  1. Initialization: memctx start boots the local daemon.
  2. Seamless Hooks: MemCTX injects directly into Claude Code via ~/.claude/settings.json.
  3. Session Start: MemCTX computes past context, open tech debt, and immediate next steps, piping it directly into Claude's System Prompt via the SessionStart hook.
  4. Live Telemetry: A background worker monitors streams via a hybrid 10-turn or 5-minute snapshot strategy.
  5. Session Extraction: MemCTX analyzes gamified session stats (Aha! moments, tech debt, flow states).
  6. Dashboard Visualization: Review your timeline, metrics, and architecture maps in a beautiful React SPA!

💻 CLI Reference

CommandDescription
memctx installInstall hooks and start daemon
memctx startBoot the background worker daemon
memctx stopStop the background worker daemon
memctx statusShow daemon status and SQLite health
memctx openOpen the React dashboard in your browser
memctx search <Q>Search sessions directly from the terminal
memctx exportExport all sessions to clean Markdown files
memctx uninstallRemove all hooks and gracefully stop daemon

🔧 Configuration

While MemCTX typically runs instantly out of the box, you can fine-tune it in http://localhost:9999/settings or via environment variables:

export ANTHROPIC_API_KEY="sk-ant-..."      # Required for rich summaries
export ANTHROPIC_BASE_URL="..."            # Support for proxies like 9router
export MEMCTX_PORT=8080                    # Custom Daemon Port (Default: 9999)
export MEMCTX_DB_PATH="/path/to/db.sqlite" # Custom DB path

⭐ Star us on GitHub — it motivates us a lot!

Star History Chart

💡 Open Source & Community

GitHub Discussions Discord Twitter

MemCTX is built by and for the developer community. We heartily welcome contributions and feedback!

MIT Licensed • Made with ❤️ by Fahad Aziz Qureshi

Ver o original no GitHub

Bom para

Relacionados