artwist-polyakov/polyakov-claude-skills

Agent Deck CLI

Gestionnaire de sessions terminal pour agents AI. Permet de lancer, contrôler et récupérer les résultats de sessions Claude enfants.

Lancer un sous-agent

Déclencheurs : "lance un agent", "lance un sous-agent", "launch sub-agent"

Lancement simple (commandes CLI)

# Créer une session
agent-deck add -t "Titre" -c claude /path/to/workdir

# Créer comme session enfant de l'agent courant
agent-deck add -t "Titre" --parent "Parent" -c claude /path/to/workdir

# Démarrer
agent-deck session start "Titre"

# Envoyer une tâche
agent-deck session send "Titre" "Ta tâche..."

Lancement automatique (script)

scripts/launch-subagent.sh "Titre" "Prompt" [--mcp exa] [--wait]

Le script automatise :

• La détection de la session et du profil courants
• La création d'une session enfant
• L'attente de l'initialisation de Claude
• L'envoi du prompt

Modes de récupération du résultat

Mode	Commande	Quand l'utiliser
Fire & forget	(sans --wait)	Par défaut. Dis : "Demande-moi quand c'est prêt"
À la demande	agent-deck session output "Titre"	Quand l'utilisateur demande
Bloquant	--wait	Résultat immédiat nécessaire

---

Vérifier le statut

Déclencheurs : "vérifie la session", "vérifie le statut", "check session"

agent-deck status                          # Toutes les sessions (résumé)
agent-deck session show "Titre"            # Détails d'une session spécifique
agent-deck session show -json "Titre"      # Format JSON
agent-deck session current                 # Session courante (dans laquelle on travaille)
agent-deck session current --json          # Session courante en JSON

Statuts :

• ● en cours d'exécution (running)
• ◐ en attente d'entrée (waiting)
• ○ inactif (idle)
• ✕ erreur (error)

---

Obtenir le résultat

Déclencheurs : "affiche la sortie de l'agent", "qu'a répondu l'agent", "show agent output"

agent-deck session output "Titre"

---

Connexion MCP

agent-deck mcp list                        # Serveurs MCP disponibles
agent-deck mcp attach "Titre" exa          # Attacher MCP à la session
agent-deck session restart "Titre"        # OBLIGATOIRE après attachement !

MCP recommandés

Tâche	Serveurs MCP
Recherche web	exa, firecrawl
Documentation de code	context7
Raisonnements complexes	sequential-thinking

---

Gestion des sessions

# Cycle de vie
agent-deck session start "Titre"
agent-deck session stop "Titre"
agent-deck session restart "Titre"

# Liste de toutes les sessions
agent-deck ls
agent-deck ls -json

# Supprimer une session
agent-deck rm "Titre"

---

Règles importantes

1. Les drapeaux avant les arguments : session show -json name (pas session show name -json)
2. Après mcp attach obligatoirement session restart pour appliquer les modifications
3. Éviter le polling des résultats d'autres agents — cela peut interférer avec la session cible
4. Identification de session : on peut utiliser le nom, l'ID (≥6 caractères) ou le chemin

---

Exemples d'utilisation

Lancer un agent de recherche

# Créer un agent pour une recherche web
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "Trouve des informations sur les dernières tendances en IA"

Vérifier l'état

# Vérifier le statut
agent-deck session show "Researcher"

# Si le statut est ◐ (waiting) — l'agent a terminé, obtenir le résultat :
agent-deck session output "Researcher"