ARRÊTEZ. LISEZ CE SKILL.MD EN ENTIER AVANT D’APPELER UN POINT DE TERMINAISON.
Agent Inbox
Messagerie inter-agents basée sur fichiers avec répartition en mode headless et intégration task-monitor.
Flux de travail principal
- Envoi : L’agent A envoie un bug/demande au projet B avec un modèle et une commande de vérification
- Triage : L’IA classifie la sévérité, ajuste la priorité/le modèle, achemine vers le projet
- Répartition : Un agent headless est créé avec le modèle spécifié pour corriger le problème
- Suivi : task-monitor affiche la progression en temps réel (0 % → 25 % → 50 % → 75 % → 100 %)
- Vérification : La commande de test s’exécute avant l’accusé de réception automatique – les échecs renvoient à l’agent
- File de discussion : Réponses/échanges en fil pour les conversations multi-messages
Configuration
# Enregistrer des projets (une seule fois)
.pi/skills/agent-inbox/agent-inbox register memory /home/user/workspace/memory
.pi/skills/agent-inbox/agent-inbox register scillm /home/user/workspace/litellm
# Lister / vérifier
.pi/skills/agent-inbox/agent-inbox projects
.pi/skills/agent-inbox/agent-inbox whoami
Commandes
| Commande | Description |
|---|---|
register <nom> <chemin> | Enregistrer un projet |
unregister <nom> | Supprimer un projet |
projects [--json] | Lister les projets enregistrés |
whoami | Afficher le projet détecté pour le répertoire courant |
send --to PROJET --type TYPE "msg" | Envoyer un message (types : bug, request, info, question) |
check [--project P] [--all] [--quiet] | Vérifier la boîte de réception |
list [--project P] [--status S] [--json] | Lister les messages |
read MSG_ID [--json] | Lire un message |
ack MSG_ID [--note "..."] | Accuser réception / terminer |
reply MSG_ID "msg" | Répondre (auto-fil) |
thread THREAD_ID | Voir l’intégralité de l’échange en fil |
update-status MSG_ID STATUS [--note] | Mettre à jour le statut manuellement |
triage classify --message "..." [--no-llm] | Classification manuelle du triage |
triage route --message "..." | Routage automatique par chemins de fichiers |
triage log --msg-id ID | Voir le journal de décision du triage |
triage webhook-add --url URL --events E | Enregistrer un webhook |
Options d’envoi
| Option | Description | Défaut |
|---|---|---|
--model MODEL | Modèle AI : sonnet, opus-4.5, codex-5.2, codex-5.2-high | sonnet |
--timeout MINUTES | Temps de travail max de l’agent | 30 |
--test COMMAND | Commande de vérification avant accusé de réception auto. | Aucune |
--no-dispatch | Désactiver la création automatique d’agent | False |
--context-file FILE | Joindre un fichier comme contexte (répétable) | Aucun |
--priority PRIORITY | low, normal, high, critical | normal |
--no-triage | Ignorer le triage AI | False |
--dry-run | Afficher le JSON du message sans l’envoyer | False |
Sélection du modèle
| Modèle | Cas d’utilisation |
|---|---|
sonnet | Corrections simples, fautes de frappe |
opus-4.5 | Analyse complexe, architecture |
codex-5.2 | Corrections de bugs standard |
codex-5.2-high | Raisonnement approfondi, conditions de course |
Triage AI
Les messages sont automatiquement classifiés par sévérité :
- critical : crash, perte de données, sécurité, production en panne →
opus-4.5 - high : erreur, exception, échec, cassé, régression →
opus-4.5 - medium : bug, problème, incorrect, inattendu →
sonnet - low : faute de frappe, cosmétique, amélioration, mineur →
sonnet
Le routage automatique extrait les chemins de fichiers des messages et les fait correspondre aux projets enregistrés.
Progression des statuts
pending → dispatched (25 %) → in_progress (50 %) → needs_verification (75 %) → done (100 %)
Pré-hook mémoire
Le répartiteur interroge /memory avant de créer un agent pour trouver des bugs similaires et des solutions antérieures.
Vérification proactive
Les agents doivent vérifier la boîte de réception au démarrage de la session, lors d’un changement de projet, avant un travail majeur, et lorsque les utilisateurs mentionnent un autre agent ou projet.
Stockage
~/.agent-inbox/
├── pending/ # Messages non traités
├── done/ # Messages acquis
├── logs/ # Journaux de répartition
├── task_states/ # Fichiers d’état task-monitor
├── triage_logs/ # Journaux de décision du triage AI
├── webhooks.json # Webhooks enregistrés
└── projects.json # Registre des projets
Exemples
# Envoyer un bug avec vérification (crée un agent headless Opus, accusé auto. si le test réussit)
python inbox.py send --to scillm --type bug --model opus-4.5 \
--test "pytest tests/test_providers.py -x" \
"Condition de course dans l’initialisation du fournisseur"
# Joindre des fichiers de contexte
python inbox.py send --to scillm --type bug --model opus-4.5 \
--context-file src/server.py --context-file /tmp/traceback.txt \
"Plantage du serveur au démarrage"
# Vérifier et traiter la boîte de réception
python inbox.py check --all
python inbox.py read scillm_abc123
python inbox.py ack scillm_abc123 --note "Corrigé dans le commit abc123"
# Échange en fil
python inbox.py reply scillm_abc123 "Pouvez-vous fournir la trace de la pile ?"
python inbox.py thread scillm_abc123
Démon répartiteur
python dispatcher.py start # Arrière-plan
python dispatcher.py start --foreground # Débogage
python dispatcher.py status
python dispatcher.py stop
Variables d’environnement
| Variable | Description | Défaut |
|---|---|---|
AGENT_INBOX_DIR | Répertoire de la boîte de réception | ~/.agent-inbox |
TASK_MONITOR_API_URL | URL de task-monitor | http://localhost:8765 |
CLAUDE_PROJECT | Nom du projet courant | détecté automatiquement |
Intégration avec les hooks Claude Code
{
"hooks": {
"on_session_start": [
".pi/skills/agent-inbox/agent-inbox check --project $(basename $PWD) || true"
]
}
}