reference

Commandes courantes — votre boucle quotidienne brainclaw

La poignée d'appels MCP et de commandes CLI qui couvrent 90 % du travail quotidien : démarrer une session, lire le contexte, poser un claim sur un périmètre, capturer des décisions.

brainclaw fournit 66 MCP tools , mais la boucle quotidienne repose sur un noyau restreint. Mémorisez-les.

Commencer à travailler sur quelque chose

# MCP (canonical)
bclaw_work intent=execute scope="src/auth/" task="Refactor JWT verification"

# CLI fallback
brainclaw session-start --agent claude-code
brainclaw claim create "JWT verify refactor" --scope src/auth/

bclaw_work ouvre une session, charge le contexte mémoire de taille prompt, et crée un claim — trois étapes en un seul appel.

Lire l’espace de travail

bclaw_context kind=memory path="src/auth/"     # decisions/traps/plans relevant to scope
bclaw_context kind=board                        # active claims, plans, handoffs across the workspace
bclaw_context kind=delta since=sess_abc123      # what changed since prior session

Choisissez le type qui correspond à la question : memory pour “qu’est-ce que je dois savoir sur ce périmètre”, board pour “que fait tout le monde en ce moment”, delta pour “ce qui a changé depuis ma dernière vérification”.

Capturer une décision ou un trap

# MCP (typé)
bclaw_create entity=decision data={text: "OAuth via auth-gateway", author: "claude-code"}
bclaw_create entity=trap data={text: "Don't store JWT secret in .env.example", severity: "high"}

# Capture rapide (auto-classifie)
bclaw_quick_capture text="On a décidé de remplacer REST par tRPC sur la surface admin"

Passer le relais au prochain agent

brainclaw handoff "Refactor JWT terminé à 80 %. Le test d'expiration du jeton échoue encore." \
  --plan pln_xyz \
  --pre-condition "Lancer npm test avant de reprendre" \
  --post-condition "Tous les auth/*.test.ts passent"

Clôturer

bclaw_release_claim id=clm_a planStatus=done
brainclaw session-end --auto-release         # CLI: release any open claims

C’est fait. La session de demain reprendra ici via bclaw_context kind=delta since=<this-session-id>.