Oh-My-Pi

Connectez Oh-My-Pi (omp), un agent de code open source pour le terminal, à votre compte Neuronz.ai grâce à son extension native. Neuronz.ai fonctionne dans des sessions Oh-My-Pi ordinaires, au moyen du système d'extensions, des skills et du MCP d'Oh-My-Pi lui-même. Il n'y a ni lanceur Neuronz.ai ni binaire omp modifié : Oh-My-Pi lit le manifeste du plugin et charge lui-même l'extension dans chaque session.

Prérequis

• Un compte Neuronz.ai avec une adresse e-mail vérifiée : voir Créer votre compte.
• Oh-My-Pi 18.0.5 ou plus récent (omp --version).
• Python 3 dans le PATH. Les scripts du plugin n'utilisent que la bibliothèque standard.
• git dans le PATH : Oh-My-Pi s'en sert pour télécharger le plugin.

1. Installez le plugin

Ajoutez le dépôt Neuronz.ai comme marketplace Oh-My-Pi, puis installez-en le plugin, en deux étapes, comme dans Claude Code :

omp plugin marketplace add \
  https://github.com/neuronzai/neuronzai.git
omp plugin install neuronzai@neuronzai

Oh-My-Pi récupère le dépôt dans son propre cache, lit le catalogue qu'il partage avec Claude Code, et installe une copie versionnée du plugin dans son dossier de plugins (~/.omp/plugins). Chaque session suivante le charge automatiquement : aucune option à passer, aucun de vos fichiers à modifier.

Si Oh-My-Pi ne trouve pas le plugin

• Ajoutez la marketplace par son URL git, comme ci-dessus. Un lien direct vers le fichier du catalogue ne permet pas de servir le plugin, qui se trouve dans un sous-dossier du dépôt.
• Le dossier de plugins suit $HOME et l'option --profile d'Oh-My-Pi. La variable d'environnement PI_CODING_AGENT_DIR ne le déplace pas.

Après l'installation, ouvrez une nouvelle session Oh-My-Pi.

2. Connectez-vous

Lancez Oh-My-Pi, puis :

/neuronzai:login

La commande ouvre Neuronz.ai dans votre navigateur, vous y connecte, puis conserve la connexion dans le trousseau de votre système quand il y en a un. Les outils du plugin et ses étapes automatiques partagent cette connexion.

Une fois connecté, la commande vous demande si Oh-My-Pi doit installer automatiquement les mises à jour du plugin. Voir Mettre à jour pour ce que cela change.

Sur une machine sans navigateur, la commande affiche un lien. Ouvrez-le sur un autre appareil, approuvez la demande, puis collez dans Oh-My-Pi le code à usage unique. Lancez /neuronzai:logout pour révoquer la machine plus tard.

3. Vérifiez

Ouvrez une nouvelle session. Si elle s'ouvre sur ⚠ Neuronz.ai is not signed in, relancez /neuronzai:login. Un nouveau compte est vide au départ : une installation qui fonctionne n'affiche donc rien d'autre au début de la session tant que vous n'avez rien enregistré. Pour vérifier l'installation elle-même, listez les plugins d'Oh-My-Pi :

omp plugin list

La ligne neuronzai@neuronzai (<version>) (user) correspond au paquet installé. Dans une session, /mcp affiche le serveur Neuronz.ai sous la forme neuronzai:neuronzai ● connected (c'est l'identifiant du serveur ; celui du plugin est neuronzai@neuronzai). Il se connecte tout seul : s'il apparaît sous « Disabled », c'est qu'un /mcp disable lancé dans une session précédente l'a mis sur votre liste de blocage, et /mcp enable neuronzai:neuronzai l'en retire.

Si une session démarre sur une version d'Oh-My-Pi antérieure à 18.0.5, le plugin affiche un avertissement visible sur les prérequis.

4. Utilisez les workflows

Oh-My-Pi propose les workflows fournis sous forme de commandes slash préfixées :

/neuronzai:capture
/neuronzai:init-profile
/neuronzai:switch-profile backend
/neuronzai:reload-assets

Les skills, commandes et agents que vous enregistrez dans Neuronz.ai pour le profil en cours sont placés au début de la session dans .omp, à l'intérieur du dépôt dans lequel vous travaillez : c'est là qu'Oh-My-Pi cherche les skills et commandes du projet. Ils ne sont partagés ni avec vos autres dépôts ni avec un autre agent.

Reprendre une session conserve son dossier d'origine

omp -r <session> rétablit le dossier dans lequel la session a été créée, et --cwd ne le remplace pas. Tout ce qui découle du dossier suit l'ancien : le profil qui répond au rappel, ainsi que les skills et commandes qu'Oh-My-Pi a trouvés sur le disque. Si vous reprenez une session depuis un autre dépôt, vous obtenez la mémoire et les ressources du premier dépôt, dans le terminal du second.

Neuronz.ai ne peut pas changer après coup le dossier d'une session : il vous le signale donc. Au début de la session, un avertissement nomme les deux dossiers :

⚠ Neuronz.ai: this session is running in /path/it/was/created/in, but you launched it from /path/you/are/in.

Ouvrez une nouvelle session dans le dossier où vous voulez travailler. Reprendre une session ne pose aucun problème tant que vous la reprenez là où elle a commencé.

Mettre à jour

Oh-My-Pi vérifie les mises à jour de plugins sur ses marketplaces à chaque démarrage, et le réglage marketplace.autoUpdate décide de ce qu'il fait d'une nouvelle version :

Valeur	Au démarrage
notify (par défaut)	Oh-My-Pi signale la mise à jour dans son journal de débogage uniquement : vous ne voyez rien et rien n'est installé
auto	Oh-My-Pi installe lui-même la mise à jour
off	Oh-My-Pi ne vérifie rien

Avec la valeur par défaut, le plugin reste à la version installée jusqu'à ce que vous le mettiez à jour à la main. Pour rester à jour sans y penser, activez une fois pour toutes les mises à niveau automatiques :

omp config set marketplace.autoUpdate auto

/neuronzai:login vous propose de le faire après la connexion, et ne modifie le réglage que si vous acceptez. Ce réglage appartient à Oh-My-Pi : il s'applique donc à tous les plugins de marketplace que vous avez installés, pas seulement à Neuronz.ai.

Oh-My-Pi rafraîchit sa copie d'une marketplace au plus une fois par jour : une nouvelle version est donc prise en compte au premier démarrage qui suit ce rafraîchissement. La mise à niveau a lieu pendant le démarrage de la session, et la nouvelle extension est chargée à partir de la session suivante.

Pour mettre à jour tout de suite :

omp plugin marketplace update neuronzai
omp plugin upgrade neuronzai@neuronzai

Les deux lignes sont nécessaires. upgrade installe la version la plus récente listée dans la copie locale de la marketplace d'Oh-My-Pi, sans rafraîchir elle-même cette copie : sans le marketplace update préalable, elle indique la version que vous avez déjà. Ouvrez une nouvelle session Oh-My-Pi pour charger l'extension mise à jour. Votre connexion reste valable d'une mise à jour à l'autre.

Désinstaller

omp plugin uninstall neuronzai@neuronzai

Cette commande supprime l'entrée du fichier de verrouillage et la copie installée. Lancez d'abord /neuronzai:logout si vous voulez aussi supprimer la connexion de cette machine.

Et ensuite

• Concepts clés : ce que font la mémoire, les connaissances, les sujets et le graphe.
• Fonctions par harnais (en anglais) : le tableau complet des fonctionnalités, pour chaque harnais d'agent (harness).
• Authentification et clés d'API : le détail du stockage et la solution de repli sans interaction.