forge-memory

Original：🇺🇸 English
Translated

FORGE Vector Memory — Diagnostic tool for the vector memory index. Operations: sync, search, status, reset. Usage: /forge-memory sync | /forge-memory search "query" | /forge-memory status | /forge-memory reset

2installs
Sourcefwehrling/forge
Added on

NPX Install

npx skill4agent add fwehrling/forge forge-memory

Tags

Translated version includes tags in frontmatter
vector-memory-diagnosticforge-skillhybrid-searchsqlite-indexembedding-management

SKILL.md Content

View Translation Comparison →

/forge-memory — FORGE Vector Memory

Outil de diagnostic pour l'index vectoriel de la mémoire FORGE. Les commandes FORGE utilisent automatiquement la recherche vectorielle ; ce skill est pour le diagnostic et la maintenance.

French Language Rule

All content generated in French MUST use proper accents (é, è, ê, à, ù, ç, ô, î, etc.), follow French grammar rules (agreements, conjugations), and use correct spelling.

Prérequis

Le système doit être installé :
bash
bash ~/.claude/scripts/forge-memory/setup.sh

Commandes

Synchroniser l'index

Synchronise les fichiers Markdown vers la base SQLite :
bash
~/.claude/scripts/forge-memory/forge-memory sync [--force] [--verbose]
  • Sans 
    --force
    : réindexe uniquement les fichiers modifiés (basé sur le hash SHA-256)
  • Avec 
    --force
    : réindexe tous les fichiers
  • Avec 
    --verbose
    : affiche le détail de chaque fichier traité

Rechercher

Recherche hybride (vectorielle + texte) dans la mémoire :
bash
~/.claude/scripts/forge-memory/forge-memory search "query" [--namespace all|project|session|agent] [--agent NAME] [--limit 5] [--threshold 0.3] [--pretty]
  • --namespace
    : filtrer par type (project = MEMORY.md, session = logs, agent = mémoires d'agent)
  • --agent
    : filtrer par nom d'agent (pm, architect, dev, qa)
  • --limit
    : nombre max de résultats (défaut: 5)
  • --threshold
    : score minimum (défaut: 0.3)
  • --pretty
    : affichage formaté (sinon JSON)

Statut

Affiche les statistiques de l'index :
bash
~/.claude/scripts/forge-memory/forge-memory status [--json]

Réinitialiser

Supprime et recrée la base de données :
bash
~/.claude/scripts/forge-memory/forge-memory reset --confirm

Architecture

.forge/memory/
  MEMORY.md              <- source de vérité (écrit par les agents)
  sessions/YYYY-MM-DD.md <- source de vérité (écrit par les agents)
  agents/{agent}.md      <- source de vérité (écrit par les agents)
  index.sqlite           <- index dérivé (synchronisé depuis les .md)
  • Synchronisation unidirectionnelle : Markdown -> SQLite
  • Auto-sync avant chaque recherche (vérifie les changements)
  • Recherche hybride : similarité vectorielle (70%) + FTS5 BM25 (30%)
  • Embeddings locaux : sentence-transformers all-MiniLM-L6-v2 (384 dimensions)
  • Chunking markdown-aware : ~400 tokens/chunk, 80 tokens overlap