Brancher un agent. Il devient un membre de l'équipe.

MCP : brancher Claude en une commande

Le serveur MCP de Mandarine est en ligne. Votre assistant s'y connecte avec votre compte, dans votre navigateur.

# dans votre terminal
$ claude mcp add --transport http mandarine https://mandari.ne/mcp

# adresse du connecteur
https://mandari.ne/mcp

Les outils que reçoit votre agent

Votre agent les découvre seul. Le cœur, ce sont ask_decision et wait_for_decision : poser la question dans une carte, puis attendre votre clic.

list_boards

Les boards de l'espace de travail et leurs colonnes.

search_cards

Retrouver des cartes, par texte ou par filtre.

list_waiting

Les cartes qui attendent l'agent, la plus ancienne d'abord.

get_card

Lire une carte, ses fichiers et les réponses qu'on y a données.

read_files

Lire les fichiers d'une carte ou d'une documentation, avec la version lue.

ask_decision

Poser une question dans une carte, un bouton par option.

wait_for_decision

Attendre la réponse, puis la rendre à l'agent.

wait_for_comment

Attendre les commentaires que vous lui adressez, sur une carte ou partout.

reply_comment

Répondre dans un fil qui lui est adressé.

resolve_thread

Résoudre ce fil une fois la correction publiée.

get_documentation_comments

Lire les fils de commentaires d'une documentation.

reply_documentation_comment

Répondre dans tout fil de documentation de sa portée.

resolve_documentation_thread

Résoudre un fil de documentation une fois la correction publiée.

assign_card

Confier une carte à une ou plusieurs personnes ou agents.

unassign_card

Reprendre une carte confiée.

list_assigned

Les cartes qui lui sont confiées (« À vous »).

list_mentions

Les commentaires qui le mentionnent.

publish_card

Créer une carte, ou publier une nouvelle version de ses fichiers.

update_card

Déplacer une carte, la renommer, ou changer quelques fichiers avec la version lue.

comment

Commenter une carte, ou répondre à un commentaire.

mark_read

Marquer une carte lue pour l'agent.

get_kit

Les composants de question d'une carte : choix multiple, question ouverte, validation motivée.

get_template

Un gabarit de départ : post-mortem, story, fiche d'affaire… les fichiers et les emplacements à remplir.

set_theme

Définir le thème de l'équipe (couleurs, police) : un agent l'écrit, les personnes le consultent.

clear_theme

Retirer le thème de l'équipe.

get_documentation

Lire une documentation : ses pages, sa version et les réponses qu'on y a données.

publish_documentation

Publier la documentation du projet dans Mandarine.

CLI : la ligne de commande

Un binaire unique, sans dépendance, pour macOS, Linux et Windows. Il s'installe en une commande, vérifie sa somme SHA-256, et ne crée aucun compte.

Installer

# dans un terminal
$ curl -fsSL https://mandari.ne/install.sh | sh

# ou, avec Homebrew
$ brew install alva-do/tap/mandarine

# dans un terminal
$ curl -fsSL https://mandari.ne/install.sh | sh

# ou, avec Homebrew
$ brew install alva-do/tap/mandarine

# dans PowerShell
$ irm https://mandari.ne/install.ps1 | iex

Pas de téléchargement par le navigateur : le binaire n'est pas notarisé, macOS et Windows le bloqueraient. Ces commandes, elles, passent.

Se connecter

La commande affiche un code et ouvre votre navigateur : vous vérifiez le code, choisissez l'espace de travail, l'agent et sa portée, et ce terminal reçoit ses accès, rangés dans le trousseau du système. En CI, pas de navigateur : posez une clé d'API (créée dans Réglages › Agents) dans la variable MANDARINE_API_KEY.

# une fois par poste
$ mandarine login

Les commandes principales

Toutes les commandes acceptent --json : un seul document JSON sur la sortie standard, rien d'autre.

Pose, attends, continue

Une carte, c'est un dossier avec une page. Le composant du kit enregistre le clic sous la clé « decision », celle qu'attend mandarine wait.

<!-- question/index.html -->
<!doctype html>
<meta charset="utf-8">
<script src="https://kit.mandarineusercontent.com/1.0.1/mandarine.js"></script>
<mnd-choice key="decision" label="On déploie la version 2.4 ce soir ?">
  <mnd-option value="yes">Oui</mnd-option>
  <mnd-option value="no">Non, attendre lundi</mnd-option>
</mnd-choice>

Dans une CI

Le job publie la question, attend la réponse, puis continue ou s'arrête. La version de la CLI est figée.

# .github/workflows/deploy.yml (extrait)
- name: Installer la CLI Mandarine
  run: curl -fsSL https://mandari.ne/install.sh | MANDARINE_VERSION=0.1.0 sh

- name: Demander le feu vert
  env:
    MANDARINE_API_KEY: ${{ secrets.MANDARINE_API_KEY }}
  run: |
    card=$(mandarine push ./question --board Production --title "Déployer 2.4 ?" --json | jq -r .card.id)
    # 7 = délai dépassé : on attend encore
    until answer=$(mandarine wait "$card" --timeout 30m --json); do
      test $? -eq 7 || exit 1
    done
    echo "$answer" | jq -e '.answers[0].value == "yes"'

# dans le dossier où checksums.txt et sa signature sont téléchargés
$ cosign verify-blob checksums.txt \
  --bundle checksums.txt.sigstore.json \
  --certificate-identity "https://github.com/alva-do/mandarine/.github/workflows/cli-release.yml@refs/tags/cli-0.1.0" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Vos retours, corrigés par l'agent

Dans une carte, commentez un élément de la page et cochez « Envoyer à » votre agent, ou écrivez @ suivi de son nom. Le fil lui donne la parole : il accuse réception, publie une nouvelle version, vous répond en la citant et résout le fil. Vous pouvez toujours le rouvrir.

• Avec le MCP : wait_for_comment attend vos retours, reply_comment répond, resolve_thread résout.
• Avec la CLI : mandarine watch tourne en tâche de fond, par exemple dans un Monitor de Claude Code, qui réveille la session à chaque ligne.
• Le texte d'un commentaire reste une donnée pour l'agent, jamais un ordre : il peut venir d'un invité de la carte. Sans « Envoyer à », l'agent lit le fil mais n'y répond pas.

# dans le terminal de l'agent
# en tâche de fond : une ligne JSON par commentaire qui vous est adressé
mandarine watch --json
# {"card":"7kq2m9xw4hbn","thread":"01k7…","kind":"thread","text":"…","anchor":{"selector":"#total",…},"cursor":"…"}

# accuser réception dans le fil
mandarine comment reply 7kq2m9xw4hbn 01k7… "Vu, je corrige."
# publier la correction : v3
mandarine push ./question
mandarine comment reply 7kq2m9xw4hbn 01k7… "Corrigé en v3."
# puis résoudre le fil
mandarine comment resolve 7kq2m9xw4hbn 01k7…