docs: refresh wiki for v12.6.0 and GitHub hosting
Clear the two remaining dead links and refresh the stale numbers on Home
Both dead links predate the diagram work and were found by walking every
internal link in the wiki:
- Screenshot-Automation-Guide pointed at SCREENSHOT_UPLOAD_INSTRUCTIONS.md,
which exists nowhere in the wiki or its archive. Dropped the entry.
- 11-Agent-Integrations-Guide rendered a broken "[CHANGELOG](link)" inside an
example of a bot comment. It was placeholder prose, so it is plain text now.
Home also still advertised v11.7.0 and ~2,780 tests. Now v11.10.0 and ~3,000,
counted rather than guessed: pytest --collect-only reports 3007. The ASCII
architecture box keeps its column width. The 28 MCP tools figure was checked
against the registry and still holds.
Every internal wiki link now resolves.
Give both diagram pages English names and content, and clear the number collisions
The wiki numbering had two pages on 14 and two on 15. Both collisions are gone:
the page with fewer inbound links moved in each pair, so the heavily linked
Quality System and ONNX guides keep their URLs.
- 15-Archify-Diagramm -> 22-Architecture-Diagram (translated)
- 21-Deployment-Landschaft -> 21-Deployment-Landscape (translated, number kept)
- 14-Contributor-Promotion -> 23-Contributor-Promotion (rename only)
The architecture page now says what the diagram actually shows: the service as
embedded in a local Hermes agent, one example rather than a canonical
deployment. Seven inbound links updated across Home.md and the roadmap.
Also fixes a dead nav link in Home.md that pointed at Windows-Hybrid-Backend-Setup
instead of Windows-Hybrid-Setup.
Point the diagram pages at mcpmemory.services and add the deployment landscape
The iframe on the Archify page never rendered: the wiki serves neither iframes
nor raw HTML. Both diagrams now live on Cloudflare Pages, deployed with the rest
of site/, so the wiki pages link out instead of embedding.
Adds the deployment landscape page: which forge builds, which mirrors pull, and
which registries get published to — including the fact that the Forgejo runner
and the Gitea mirror share one Hetzner VM.
Numbered 21 rather than 16, because 14, 15 and 16 already carry two pages each.
docs(home): add Heavybit interview + MichaÅ Zubkowicz testimonial
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add token-efficient retrieval guide; correct stale facts on Home
memory_explore and memory_detail shipped in v11.1.0 with no user-facing
documentation anywhere, which is how a user with 11k memories came to file
a feature request for most of what they already do (#215). New page walks
from the symptom — search responses eating 10k tokens — through limit and
max_response_chars, then the two-phase map for people who want an overview
before pulling content.
It leads with the prerequisite, because memory_explore returns count=0 for
every query until the entity graph is populated and nothing populates it by
default. Also documents the two traps that cost real time: maintain's
dry_run defaults to true and stores nothing, and MCP_MAINTAIN_SCAN_LIMIT
defaults to 2000 taking the first N in storage order, so repeated runs
never reach the tail of a larger store.
Home had drifted badly: it advertised v10.65.1 and ~1,828 tests, claimed
MIT when the project is Apache-2.0, said 12 MCP tools where the registry
now has 28, and every repository link pointed at github.com — which sends
readers to the suspended mirror rather than Codeberg. Codeberg has no
Discussions feature, so the "Question?" link now points at issues instead
of a page that does not exist.
The What's New section still stops at v10.65.1 and is left for the release
workflow to bring forward.
docs(wiki): overhaul Home.md â v10.65.1, remove stale v7.x content, modern structure
merge(wiki): consolidate Cloudflare cluster (#833 draft)
Three-way Cloudflare/Hybrid guide cluster identified by housekeeping audit
2026-05-02 (F-033). Resolution favors lightweight reframing over heavy
content merge — the three guides cover distinct topologies but the
deprecated multi-machine framing is now redundant since hybrid mode
handles multi-machine sync natively.
### Removed
- Cloudflare-Based-Multi-Machine-Sync.md (507 lines)
- Pre-hybrid (v6.13.7) framing of multi-machine sync as a separate
architecture is now obsolete — hybrid backend IS the multi-machine
sync solution
- Architecture diagram useful but redundant with Hybrid_Setup_Configuration
- Migration script superseded by built-in memory_ingest tooling
### Updated
- Cloudflare-Backup-Sync-Setup.md
- Added a top-of-page guidance block: "Most users want
Hybrid_Setup_Configuration, not this guide"
- Lists the legitimate remaining use cases (DR-only export, custom
one-way sync, resource-provisioning reference)
- Steps 1–2 (Cloudflare resource creation + token) remain canonical
even when configuring hybrid
- Hybrid_Setup_Configuration.md
- Removed stale "Version 8.9.0" header (current is v10.48.0; version
callouts inline still note v8.9.0+ for specific features)
- Added explicit "Multi-Machine: ✅ canonical solution" callout in
the metadata block
- Cross-link to Cloudflare-Backup-Sync-Setup steps 1–2 for resource
provisioning instead of duplicating those steps
- Home.md
- Dropped the Multi-Machine-Sync link from the Setup & Configuration
section
### Net change
~520 lines removed, 2 cross-links added, 1 deprecation guidance block
added. No content lost — anything load-bearing in Multi-Machine-Sync was
already covered in Hybrid_Setup_Configuration.
This commit is on branch merge/cloudflare-cluster-833 — review before
merging to master.
fix(wiki): Home navigation rewrite — full page index visible from Home
Add "All Wiki Pages" section to Home.md indexing all 19 numbered guides
plus 14 supplementary pages (Hybrid setup, Cloudflare, OAuth, Windows,
consolidation, hooks, AppleScript, Claude AI Remote MCP, templates, etc.).
Previously Home.md had links only to ~8 guides in the Documentation tables;
the remaining 25+ pages were invisible from navigation (F-030).
Fixes housekeeping audit finding F-030
Audit report: /Users/hkr/Repositories/mcp-memory-service/docs/superpowers/specs/2026-05-02-housekeeping-audit-report.md
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: add Contributor Promotion governance page
Documents the criteria for CODEOWNERS entries: ≥3 merged PRs in a
focused area, reproducer-backed quality, scope discipline, 90-day
demotion window. Validated quarterly via automated routine.
Current owners: @zc277584121 (Milvus backend), @henry201605 (Milvus
graph + BM25), @filhocf (quality system, services/memory_service.py).
Branch protection has require_code_owner_reviews=false — CODEOWNERS
is review-pings, not gatekeeping.
docs: add Claude.ai Remote MCP Integration guide
New wiki page covering how to connect mcp-memory-service to claude.ai
via HTTPS Streamable HTTP transport with OAuth 2.1. Includes quick start
with Cloudflare Tunnel, full configuration reference, deployment options,
and troubleshooting.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Update documentation for v9.3.0: enhance Web Dashboard Guide with GIFs and add Screenshot Automation Guide
docs(wiki): Memory Quality System Era documentation (v8.45-v8.48)
Major documentation update covering 11 releases across 3 days:
## New Wiki Pages
- 14-Memory-Quality-System-Guide.md (updated) - Comprehensive v8.45-v8.48 coverage
- 15-ONNX-Quality-Evaluation.md (new) - Cross-encoder deep dive, self-match bug analysis
- 16-Metadata-Compression-System.md (new) - CSV compression, 78% reduction, 3-phase roadmap
- 17-Quality-Hooks-Integration.md (new) - 3-phase integration workflow
- 18-Dashboard-UI-Guide.md (new) - Quality badges, analytics, dark mode
## Key Documentation Themes
- Local-first AI (zero cost, full privacy, ONNX SLM)
- 78% metadata compression for cloud sync (100% success rate)
- Realistic quality distribution (42.9% high, 3.2% med, 53.9% low)
- Multi-platform GPU acceleration (CUDA, MPS, DirectML, ROCm)
- Network effect intelligence (association-based quality boost)
- Complete bug fix transparency (self-match, association pollution)
## Release Coverage
- v8.45.0-v8.45.3: Foundation and stabilization
- v8.46.0-v8.46.3: Quality + Hooks integration
- v8.47.0-v8.47.1: Association boost, ONNX improvements
- v8.48.0: Metadata compression breakthrough
## Documentation Quality
- 5 comprehensive wiki pages (~50KB total)
- Cross-references between all pages
- Platform-specific configuration examples
- Troubleshooting guides for all common issues
- Performance benchmarks with real-world data
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: add fancy navigation footers to all wiki pages
Implemented hybrid footer approach:
- Card-Style footer (comprehensive navigation) for main pages:
* Home.md
* 01-Installation-Guide.md
* 03-Integration-Guide.md
* 07-TROUBLESHOOTING.md
* 10-Complete-Feature-List.md
* 11-Agent-Integrations-Guide.md
* 12-Using-Agents-in-Other-Repositories.md
* Memory-Hooks-Complete-Guide.md
- Minimal footer (one-liner) for reference pages:
* 02-Platform-Setup-Guide.md
* 04-Advanced-Configuration.md
* 05-Performance-Optimization.md
* 06-Development-Reference.md
* 08-FAQ.md
* 09-Examples.md
* OAuth-2.1-Setup-Guide.md
* Web-Dashboard-Guide.md
* Context-Provider-Workflow-Automation.md
Footer features:
- 📚 Documentation links (Home, Installation, Integration, Troubleshooting)
- 🚀 Features links (All 33 Features, Memory Hooks, Web Dashboard, OAuth)
- 🤖 Automation links (Agent Guide, Cross-Repo Setup, Context Provider)
- 🌟 Community links (GitHub, Discussions, Issues, Contribute)
- Tagline: "Zero database locks • 5ms reads • 85% accurate memory triggers"
- MIT License link
Pure Markdown formatting for maximum compatibility
🤖 Generated with Claude Code (https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: add cross-repository agent usage guide
- Created 12-Using-Agents-in-Other-Repositories.md with comprehensive migration guide
- Added language-specific guides for Python, Node.js, Rust, and Go
- Included portability matrix showing what works as-is vs needs adaptation
- Provided configuration templates and migration checklists
- Added quick start instructions for Python projects (30 min setup)
- Documented effort estimates: Node.js (2-3h), Rust (4-6h), Go (6-8h)
- Updated 11-Agent-Integrations-Guide.md with cross-reference section
- Updated Home.md with navigation link
Key additions:
- Portability overview: 95% portable (Amp CLI), 70% (Release Manager), 60% (Quality Guard)
- .claude/project.json configuration schema
- Agent-by-agent adaptation instructions
- Language-specific script rewrite examples
- Troubleshooting common cross-repo issues
🤖 Generated with Claude Code (https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: add comprehensive feature list and agent integrations guide
- Created 10-Complete-Feature-List.md with all 33 features across 8 categories
- Created 11-Agent-Integrations-Guide.md with detailed agent workflows
- Updated Home.md with navigation links to new documentation
- Each feature includes examples, use cases, and differentiators
- Agent guide covers GitHub Release Manager, Groq, Gemini, Amp CLI
🤖 Generated with Claude Code (https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: add comprehensive Web Dashboard documentation (v8.9.0)
Added:
- Web-Dashboard-Guide.md - Complete interactive dashboard documentation
- 7 tabs documented: Dashboard, Search, Browse, Documents, Manage, Analytics, API Docs
- Features: Real-time SSE updates, document upload, bulk operations, analytics
- Performance benchmarks: Page load 25ms, operations 26ms, search <100ms
- Configuration, troubleshooting, API examples, best practices
- Use cases: Project docs, bug tracking, dev journal, team collaboration
Changed:
- Home.md - Added Web Dashboard Guide to Core Guides section
- Added "Access Web Dashboard" as step 2 in Quick Start
- Renumbered steps: Basic Usage → 3, Advanced Memory → 4
- 03-Integration-Guide.md - Added "Web Dashboard (Interactive UI)" section
- Overview of dashboard features and tabs
- Quick start instructions
- Performance metrics
- Configuration examples
- Use cases and link to complete guide
- 09-Examples.md - Added "Web Dashboard Examples" section (10 examples)
- Document upload workflow
- Visual search workflow
- Tag-based exploration
- Bulk cleanup workflow
- Analytics review
- Real-time collaboration
- Time-based search
- Document batch upload
- Memory export & backup
- Tag management
**Impact**: Users now have comprehensive documentation for the production-ready web dashboard (v7.2.2+) with detailed examples for all features.
docs: update architecture diagram to v8.9.0
Changed:
- Updated "Storage Backends" to "Storage Backend" (singular)
- Added version number "v8.9" to MCP Memory Service
- Converted to bullet-point format for clarity
- Removed ChromaDB (deprecated in v8.0.0)
- Added modern AI clients: Cursor, 13+ AI Apps, Web Dashboard (Port 8888)
- Added Hybrid 🌟 with performance details (5ms local + cloud sync)
- Updated service features: HTTP Transport, Memory Store, Semantic Search, Doc Ingestion
- Added v8.9.0 highlights: Zero DB Locks ✅, Auto-Config ✅
Now matches README.md architecture diagram for consistency.
docs(wiki): update for v8.9.0 release with PyPI installation and database lock fixes
Updated:
- Home.md: Added PyPI installation as Option A in Quick Start
- 01-Installation-Guide.md: Updated to v8.9.0, added PyPI section, v8.9.0 highlights
- Hybrid_Setup_Configuration.md: Updated to v8.9.0, added SQLite pragma settings
- 07-TROUBLESHOOTING.md: Added comprehensive database lock troubleshooting section
Changes:
- PyPI installation now prominently featured across wiki
- SQLite pragma configuration (busy_timeout=15000, cache_size=20000) documented
- Database lock error troubleshooting with v8.9.0 fix
- Version bumps from 8.4.0/6.3.3+ to 8.9.0
- Updated dates to 2025-10-27
v8.9.0 Highlights:
- Zero database locks with auto-configured SQLite pragmas
- Hybrid backend as recommended default
- PyPI installation support
docs: add comprehensive Backend Configuration Issues troubleshooting
Added extensive troubleshooting section covering:
- Missing memories in dashboard (backend mismatch)
- Environment variables not loading
- Cloudflare authentication failures
- Configuration file conflicts
- Dashboard connection issues (OAuth, ports)
- Claude Code hooks timeout (Cloudflare init)
- Duplicate MCP server configurations
- Configuration best practices and debugging methodology
Includes diagnostic steps, solutions, and prevention strategies for
all major configuration issues encountered in production.
Updated Home.md to highlight new Backend Configuration Issues section.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: consolidate Memory Hooks documentation into single guide
- Create comprehensive Memory-Hooks-Complete-Guide.md (consolidates 3 guides)
- Archive Memory-Awareness-Hooks-Detailed-Guide.md to archive/
- Archive Claude-Code-v7.1.3-Enhanced-Memory-Hooks.md to archive/
- Replace Natural-Memory-Triggers-v7.1.0.md with redirect to consolidated guide
- Update Home.md navigation to point to consolidated guide
- Update Integration Guide cross-references
- Clean up duplicate content in Claude-Code-Commands-Wiki.md
- Standardize on v7.1.4 unified installer throughout
Benefits:
✅ Single source of truth for all memory hooks documentation
✅ Eliminate confusion between versions and features
✅ Reduce maintenance burden and duplicate content
✅ Improve navigation and user experience
✅ Consolidated troubleshooting and configuration
🤖 Generated with Claude Code (https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: add v7.1.3 Enhanced Memory Hooks documentation
- Add comprehensive guide for Claude Code v7.1.3+ enhanced memory awareness hooks
- Document natural memory triggers with automatic pattern detection
- Cover mid-conversation hooks for real-time memory injection
- Explain performance profiles (speed_focused, balanced, memory_aware, adaptive)
- Include dual protocol support (MCP + HTTP fallback)
- Provide complete installation, configuration, and testing procedures
- Add troubleshooting and optimization guidance
- Update Home.md to highlight latest v7.1.3 features
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: comprehensive Natural Memory Triggers v7.1.0 wiki documentation
Major wiki updates for Natural Memory Triggers v7.1.0 release:
NEW CONTENT:
- Natural-Memory-Triggers-v7.1.0.md: Complete 7,500+ word guide with installation,
configuration, CLI management, performance optimization, and troubleshooting
UPDATED PAGES:
- Home.md: Added Natural Memory Triggers v7.1.0 as latest release with key features
- Claude-Code-Commands-Wiki.md: Added comprehensive Natural Memory Triggers integration section
- Memory-Awareness-Hooks-Detailed-Guide.md: Added evolution section comparing legacy vs new system
- 03-Integration-Guide.md: Updated Claude Code integration with Natural Memory Triggers installation
- 04-Advanced-Configuration.md: Added performance optimization section for Natural Memory Triggers
KEY FEATURES DOCUMENTED:
- 85%+ trigger accuracy with intelligent pattern detection
- Multi-tier performance architecture (50ms/150ms/500ms)
- CLI management system with real-time configuration
- Git-aware context integration for enhanced relevance
- Adaptive learning based on user preferences
- Zero-restart installation with dynamic hook loading
- Performance profiles for different workflows (speed/balanced/memory-aware/adaptive)
The wiki now provides complete coverage for users to discover, install, configure,
and optimize Natural Memory Triggers v7.1.0 for intelligent Claude Code memory awareness.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: add comprehensive OAuth 2.1 Dynamic Client Registration documentation for v7.0.0
- Added OAuth 2.1 highlights to Home.md with v7.0.0 major release section
- Enhanced 03-Integration-Guide.md with Claude Code HTTP transport setup
- Created comprehensive OAuth-2.1-Setup-Guide.md with full technical documentation
- Updated 04-Advanced-Configuration.md with OAuth environment variables and security
- Added OAuth troubleshooting section to 07-TROUBLESHOOTING.md
Covers RFC 7591 & RFC 8414 compliant Dynamic Client Registration, zero-configuration
Claude Code integration, enterprise security, and team collaboration features.
Add Claude Code Commands & Hooks wiki to main navigation
- Added link to comprehensive Claude Code Commands and Memory Awareness Hooks wiki page
- Provides users easy access to complete documentation covering:
* Manual commands (/memory-store, /memory-recall, etc.)
* MCP Server Protocol integration
* Automatic Memory Awareness Hooks system
- Completes wiki navigation for all MCP Memory Service integration options
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
wiki: implement priority-based navigation ordering with numbered prefixes
PROBLEM SOLVED:
• GitHub Wiki alphabetical navigation put specialized content prominently
• "Building a React Dashboard" appeared as 3rd entry (should be much lower)
• No logical progression through essential → advanced → help content
SOLUTION IMPLEMENTED:
• Added priority numbers (01-09) to control exact navigation order
• Updated all internal links to use new numbered filenames
• Preserved all content while reorganizing navigation structure
NEW NAVIGATION ORDER:
01 📚 Installation Guide (Priority 1: Essential setup)
02 🔧 Platform Setup Guide (Priority 2: Platform optimization)
03 🔌 Integration Guide (Priority 3: Tool integration)
04 ⚙️ Advanced Configuration (Priority 4: Power user features)
05 ⚡ Performance Optimization (Priority 5: Performance tuning)
06 👨💻 Development Reference (Priority 6: Developer tools)
07 🔧 TROUBLESHOOTING (Priority 7: Problem solving)
08 ❓ FAQ (Priority 8: Common questions)
09 📝 Examples (Priority 9: Code examples)
BENEFITS:
• Essential guides appear first in navigation
• Logical user journey: setup → advanced → help
• Specialized content (React Dashboard) no longer prominently displayed
• Easy to reorder by changing prefix numbers
• Professional navigation structure matching codebase quality
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
fix: correct wiki links to point to proper wiki pages instead of raw markdown
- Remove .md extensions from internal wiki links
- Links now properly navigate to formatted wiki pages
- Fixes awkward raw markdown display in browser
- Improves user experience with proper GitHub wiki navigation
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
wiki: complete restructuring and decluttering for world-class user experience
TRANSFORMATION RESULTS:
• 22 → 10 wiki files (55% reduction)
• Clear information hierarchy with logical grouping
• Professional navigation structure
• Consolidated guides eliminate redundancy
• Historical content safely archived
NEW STRUCTURE:
📚 Core Guides (3):
- Installation-Guide.md ✅
- Platform-Setup-Guide.md ✅
- Integration-Guide.md ✅
🔧 Advanced Topics (3):
- Advanced-Configuration.md (NEW: merged Integration-Patterns + Best-Practices)
- Performance-Optimization.md (NEW: clean, actionable guide)
- Development-Reference.md (NEW: consolidated Claude Code guides)
📖 Help & Reference (3):
- TROUBLESHOOTING.md ✅
- FAQ.md (NEW: extracted from case studies)
- Examples.md (NEW: practical code examples)
🏠 Navigation Hub (1):
- Home.md (REDESIGNED: clear structure with quick start)
ARCHIVED CONTENT (10 files):
• Case studies and development journeys
• Specialized implementation guides
• Historical debugging scenarios
• React dashboard tutorial
• Memory cleanup examples
BENEFITS:
• Faster user onboarding with streamlined navigation
• Reduced maintenance burden through consolidation
• Professional presentation matching codebase quality
• Clear user journey: Home → Core Guides → Advanced → Help
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
docs: v6.4.0 - Major documentation consolidation and UX improvement
- Consolidated 6 installation guides into single comprehensive wiki guide
- Merged 5 Claude integration files into unified integration guide
- Combined 4 platform guides into optimized platform setup guide
- Streamlined README.md from 56KB to 8KB with clear wiki navigation
- Safely archived 26+ redundant files while preserving all content
- Eliminated choice paralysis with single source of truth per topic
- Improved user onboarding experience and maintainability
🧠 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Add comprehensive Claude Code Hooks Installation Guide
- Created detailed step-by-step installation and testing guide
- Documents the successful ./install.sh process with 100% test pass rate
- Covers prerequisites, configuration, verification, and troubleshooting
- Added to featured guides in Home.md for easy discovery
- Based on real successful installation with narrowbox.local:8443 setup
- Provides complete reference for memory awareness hooks system