init

Rôle du skill init

Ce skill fait partie du plugin Claude Code de PowerMem, un système de mémoire persistante et auto-évolutive pour agents IA. Son unique responsabilité est d'initialiser (ou de réparer) PowerMem une fois le plugin installé dans Claude Code — il ne couvre pas l'installation du plugin lui-même ni le workflow de développement du projet source.

Concrètement, le skill lit la section « Installed plugin initialization » du fichier SETUP.md du plugin, puis orchestre deux scripts fournis par le plugin : scripts/status.sh (vérification de l'état du serveur) et scripts/init.sh (démarrage et configuration du backend).

Ce que fait le skill en pratique

Avant de lancer init.sh, le skill interroge l'utilisateur via l'outil AskUserQuestion pour collecter les choix de configuration manquants. Le flux se déroule en trois rounds distincts :

• Round 1 — Mode serveur : local (loopback ou toutes interfaces) ou connexion à un serveur distant existant. Ce round est ignoré si POWERMEM_BASE_URL est déjà défini.
• Round 2 — Backend de stockage + LLM : choix entre SQLite (zéro-config, mono-utilisateur) et OceanBase (multi-agents, production), puis choix du fournisseur LLM pour l'extraction de faits et la réécriture de requêtes.
• Round 3 — Embedding : choix du fournisseur d'embeddings (local HuggingFace, intégré seekdb pour OceanBase, ou cloud si une clé API est détectée). Ce round est obligatoire sauf si la valeur est déjà présente dans .env.

En mode distant, les questions Storage/LLM/Embedding sont ignorées car elles sont gérées par le serveur remote. Les clés API ne sont jamais affichées en clair dans les résumés.

Détails techniques notables

Le skill gère plusieurs cas particuliers : détection de la région (pour afficher les questions en anglais et en chinois simultanément si l'IP est en CN), détection d'un fichier ~/.powermem/dev-mode pour utiliser une version locale non publiée du package au lieu de PyPI, et gestion correcte de la variable $CLAUDE_PLUGIN_ROOT injectée par le harness du plugin. Il évite également les faux-positifs d'erreurs shell en s'appuyant exclusivement sur status.sh plutôt que sur des one-liners curl/ss/netstat qui retournent des codes d'erreur quand le serveur est arrêté.

Comment l'utiliser

Ce skill se déclenche automatiquement lorsque l'utilisateur demande à Claude Code de « configurer », « initialiser » ou « réparer » PowerMem. Il n'est pas destiné à être copié ou modifié directement par les utilisateurs finaux : il fait partie intégrante du plugin claude-code-plugin du repository oceanbase/powermem et s'appuie sur les scripts et la configuration présents dans ce repo.