pi-config — Ultra Orchestrator

29 packages · 20 agents ultra-précis · 18 skills · 7 workflows stricts · 5 extensions custom (10 tools) · Pi 0.84.4

Gestion des packages npm

Pi ne s'installe pas avec npm install dans ce repo. Tout est déclaré dans settings.json et géré par pi lui-même.

Ajouter un package

pi install npm:pi-lens
# -> installe dans ~/.pi/agent/npm/ et ajoute "npm:pi-lens" dans settings.json
git add settings.json
git commit -m "add pi-lens"
git push

Retirer un package

pi uninstall npm:pi-lens
git add settings.json
git commit -m "remove pi-lens"
git push

Lister

pi list

Installer sur nouvelle machine (après git clone)

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
git clone <ton-remote> ~/.pi/agent
pi update --extensions   # lit settings.json et installe les 29 packages
pi  # /login pour auth

Sync après git pull

cd ~/.pi/agent
git pull
pi update --extensions   # installe les nouveaux packages ajoutés ailleurs
pi list

Ne jamais faire npm install manuel dans ~/.pi/agent/npm/ — toujours passer par pi install / pi uninstall / pi update.

Résolutions de conflits (ne pas retirer sans lire)

Certains packages se recouvrent. Les filtres dans settings.json (forme objet, mécanisme documenté pi) gardent les packages installés mais désactivent la ressource en conflit — le perdant ne chargerait de toute façon pas (erreur au démarrage sinon) :

• npm:@narumitw/pi-lsp → extensions: [] : pi-lens fournit déjà lsp_diagnostics (et gagne le conflit). Perte fonctionnelle nulle.
• npm:zob-harness → exclut .pi/extensions/zob-harness/index.ts (outils get_goal/create_goal/update_goal déjà fournis par pi-goal, cf. /goal). zob-switch, prompts et skills restent chargés. Sans ça, pi-multi-orchestrator (delegate_agent) ne charge pas non plus.
• npm:pi-hermes-memory → extensions: [] : son extension fait segfault pi au chargement dans cet environnement (bisection vérifiée, package seul). Mémoire toujours couverte par pi-blackhole + pi-obsidian + ~/memory + extension locale memory-sync. Réactiver après fix upstream ou Node LTS 22.
• npm:@erichll/pi-sandbox : ne pas confondre avec l'outil subagent local (extensions/orchestrator, single/parallel/chain avec {previous}) — le sandbox enregistre son propre subagent et perdrait. Configuré via extensions/pi-sandbox/config.json avec subagents.provider: "off" : le sandbox protège bash (bwrap) et laisse l'orchestration au subagent local.

Vérifier le démarrage : depuis un dossier neutre (jamais depuis ~/pi ou ses parents — pi-auto-review refuse fail-closed quand son code est sous le cwd), pi -p --no-session --offline "hi" doit afficher uniquement l'erreur d'auth attendue (No API key... → faire /login), sans Error: Failed to load extension.

Install complète (nouvelle machine)

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
git clone <ton-remote> ~/.pi/agent
pi update --extensions
pi  # /login

Versionner

cd ~/.pi/agent
git add -A
git commit -m "update: ..."
git push

Sync / Récupérer

cd ~/.pi/agent
git pull
pi update --extensions

Structure

agents/       # 20 agents (*.md, frontmatter model/tools)
skills/       # 18 skills (zig/rust/c/asm-x86/asm-arm/re-windows/re-linux/re-macos/cloud/ad/formal/...)
workflows/    # 7 flows YAML stricts
extensions/
  orchestrator/  # subagent tool (parallel/chain avec {previous})
  custom/        # zig/re/asm/cloud-ad/formal (10 tools)
  memory-sync.ts
settings.json # 29 packages déclarés (source de vérité)
AGENTS.md     # instructions globales
ORCHESTRATION-GUIDE.md  # usage multi-agent détaillé
README.md

Voir ORCHESTRATION-GUIDE.md et AGENTS.md pour l'orchestration.

Non versionné (.gitignore) : auth.json models-store.json trust.json sessions/ npm/ git/ cache/ bin/fd