Utiliser le CLI
Installez le CLI Multica, connectez-vous et gérez les espaces de travail, les tâches, les agents et les runtimes depuis le terminal.
Le CLI Multica sert à la fois à connecter des runtimes locaux et à gérer, depuis le terminal, les espaces de travail, les tâches, les agents et les automatisations. Cette page présente les parcours courants ; les options prises en charge par la version installée sont toujours définies par le --help de chaque commande.
Installation
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bashSi Homebrew est installé, vous pouvez aussi exécuter :
brew install multica-ai/tap/multicaVérifiez l'installation :
multica versionPremière connexion
Choisissez le service auquel vous vous connectez :
multica setupsetup enregistre l'adresse du serveur, ouvre un navigateur pour finaliser la connexion et démarre le daemon. Une fois l'opération terminée, vérifiez :
multica auth status
multica daemon statusSi vous devez seulement vous reconnecter sans écraser le reste de la configuration, exécutez multica login. Sur une machine sans navigateur, créez d'abord un jeton d'accès personnel dans les paramètres web, puis saisissez-le avec :
multica login --tokenLa commande vous invite à coller le jeton dans le terminal, ce qui évite que sa valeur complète n'apparaisse dans l'historique du shell.
Choisir un espace de travail
Listez les espaces de travail et changez celui par défaut :
multica workspace list
multica workspace switch <slug>Les commandes suivantes utilisent cet espace de travail. Une commande isolée peut le remplacer avec --workspace-id, ou vous pouvez définir MULTICA_WORKSPACE_ID.
Inviter des membres :
multica workspace member invite teammate@example.com
multica workspace member invite admin@example.com --role adminOpérations courantes sur les tâches
# Consulter et rechercher
multica issue list
multica issue get MUL-123
multica issue search "échec de connexion"
# Créer et mettre à jour
multica issue create --title "Corriger l'échec de connexion"
multica issue status MUL-123 in_progress
multica issue assign MUL-123 --to "Backend Agent"
# Commentaires et exécutions
multica issue comment list MUL-123
multica issue comment add MUL-123 --content "Vérifiez d'abord les tests de régression"
multica issue comment update <comment-id> --expected-revision 2 --content "Vérifiez les tests de régression et les notes de version"
multica issue runs MUL-123Lisez les descriptions ou commentaires longs depuis stdin pour ne pas avoir à gérer les retours à la ligne et les guillemets :
multica issue create --title "Notes de mise à niveau" --description-stdin < notes.md
multica issue comment add MUL-123 --content-stdin < review.md
multica issue comment update <comment-id> --expected-revision 2 --content-file revised-review.mdConsulter, arrêter ou relancer une exécution :
multica issue run-messages <task-id> --issue MUL-123
multica issue cancel-task <task-id> --issue MUL-123
multica issue rerun-task <run-id> --issue MUL-123
multica issue rerun-task <run-id> --issue MUL-123 --freshAjouter un commentaire à une exécution encore en cours, au lieu de mettre une exécution de suivi en file d'attente (uniquement les exécutions qui acceptent des messages supplémentaires, et seulement pour un agent que votre commentaire pourrait démarrer) :
multica issue comment add MUL-123 --content-file note.md --steer <task-id>
multica issue comment add MUL-123 --content-file note.md --steer-activeSi une tâche ouverte portant le même titre (sans tenir compte de la casse ni des espaces en trop) existe déjà sous le même projet et le même parent, issue create refuse et indique cette tâche. Pour en créer une autre malgré tout, ajoutez --allow-duplicate. Pour marquer une tâche comme doublon d'une autre, utilisez multica issue status MUL-124 cancelled --duplicate-of MUL-123.
Pour livrer plusieurs PR successives, utilisez issue create --title "..." --pr-auto-complete off ou issue update <id> --pr-auto-complete off pour conserver le statut de cette tâche après fusion. --pr-auto-complete on rétablit la règle de l'espace de travail au prochain événement PR. issue pull-requests <id> affiche le réglage de la tâche, celui de l'espace de travail, le statut cible et la décision, même sans PR liée. Les serveurs compatibles enregistrent le réglage dans la transaction de création ; les anciens reçoivent un PUT supplémentaire. En cas d'échec, le CLI indique l'ID créé et la commande update à réessayer : ne répétez pas create.
Chronologie
issue get montre la tâche telle qu'elle est maintenant. issue timeline liste dans l'ordre les changements de statut, de priorité, d'assigné, de titre et de dates ainsi que les résultats des exécutions, entremêlés avec les commentaires. C'est la commande pour savoir « quand est-elle passée en in_review » ou « depuis combien de temps est-elle bloquée dans ce statut » :
multica issue timeline MUL-123 --action status_changed
multica issue timeline MUL-123 --activity-only --output json
multica issue timeline MUL-123 --since 2026-08-19T00:00:00Z--activity-only retire les commentaires et garde tous les enregistrements d'activité ; --action ne renvoie que les actions indiquées, peut être répété et implique --activity-only. Le serveur limite l'historique qu'il lit ; si le résultat est tronqué, un avertissement s'affiche sur stderr, et il ne faut pas en déduire de durée.
Lire de longs fils de commentaires
Sur une tâche très commentée, tout lire un par un coûte beaucoup de tokens à un agent. Parcourez d'abord les fils, puis ouvrez celui qui vous intéresse :
multica issue comment list MUL-123 --roots-only --summary --output json --compact
multica issue comment list MUL-123 --thread <comment-id> --tail 5 --output json --compact--roots-onlyne renvoie que les commentaires de premier niveau, chacun avec son nombre de réponses et l'heure de sa dernière activité.--summaryréduit chaque commentaire à un court aperçu.--compacts'applique à la sortie JSON et retire les champs sans information (comme l'issue_idrépété et les tableaux vides).--recent Nrenvoie les N fils les plus récemment actifs avec toutes leurs réponses, ce qui peut être long.- Les fils résolus sont repliés par défaut sur le premier commentaire et la conclusion ; ajoutez
--fullpour le texte complet.
Les listes peuvent aussi se limiter aux champs utiles : multica issue list --output json --fields id,identifier,title,status. Le filtrage a lieu dans la CLI : il réduit la sortie et le contexte, pas la requête.
Pour lister les tâches selon leur dernière mise à jour, fournissez ensemble --updated-since et --updated-until au format RFC3339. Le serveur renvoie les tâches dont la valeur actuelle de updated_at est supérieure ou égale à since et strictement inférieure à until : [since, until). Ces options se combinent avec les filtres, le tri et la pagination existants. Gardez les mêmes bornes entre les pages ; des mises à jour simultanées peuvent modifier les résultats, car la pagination ne fournit pas d'instantané.
multica issue list --updated-since 2026-11-05T10:00:00Z \
--updated-until 2026-11-05T10:01:00Z \
--sort created_at --direction asc --limit 100 --offset 0 \
--output json --fields id,workspace_id,project_id,titleRéveils
Un réveil lance une exécution ordinaire d'un agent quand un événement se produit, qu'une condition devient vraie ou qu'une heure arrive. Les règles complètes figurent dans Réveils de tâche.
multica issue wakeup events
multica issue wakeup create MUL-123 --agent-id <agent-id> \
--event comment.created --filter-actor-type member --filter-actor-id <user-id> \
--instruction "Quand ils répondent, mettre à jour le devis d'après leur réponse"
multica issue wakeup create MUL-123 --agent-id <agent-id> \
--kind every --every 1h --expires-in 72h \
--instruction "Vérifier si le fournisseur a répondu"
multica issue wakeup list MUL-123
multica issue wakeup runs MUL-123 <wakeup-id>Créer un réveil depuis un terminal en tant que membre demande --agent-id ; un agent qui en crée un pendant sa propre exécution se réveille lui-même par défaut.
Agents et skills
multica agent list
multica agent get <agent-id>
multica agent create --help
multica agent update <agent-id> --help
multica skill list
multica skill get <skill-id>
multica skill import --url <skill-url>
multica agent skills add <agent-id> --skill-ids <skill-id>Lorsqu'un import rencontre un skill du même nom, le comportement par défaut est de s'arrêter sans modifier le contenu existant. Choisissez selon votre intention :
multica skill import --url <skill-url> --on-conflict overwrite
multica skill import --url <skill-url> --on-conflict rename
multica skill import --url <skill-url> --on-conflict skipoverwrite n'est autorisé que pour le créateur du skill et conserve l'ID d'origine ainsi que les liaisons avec les agents.
Les variables d'environnement et la configuration MCP contiennent souvent des tokens. Une valeur tapée sur la ligne de commande reste dans l'historique du shell et dans la sortie de ps ; passez-les plutôt par les formes -file ou -stdin :
multica agent create --name "Assistant ops" --runtime-id <runtime-id> \
--custom-env-file ./agent-env.json \
--mcp-config-file ./mcp.json \
--custom-args '["--max-turns", "40"]'
multica agent env set <agent-id> --custom-env-stdin < agent-env.json
multica agent update <agent-id> --mcp-config-file ./mcp.json- Les options
--custom-envn'existent que suragent create. Pour modifier les variables ensuite, utilisezagent env set, qui remplace l'ensemble ; les clés dont la valeur est****gardent leur valeur actuelle. agent update --mcp-config nullefface la configuration MCP.--custom-argsest un tableau JSON placé à la fin des arguments de lancement. Choisissez le modèle avec--model; certains outils refusent un--modeldans les arguments personnalisés.--permission-modedétermine qui peut invoquer l'agent :privatepour le propriétaire seul, oupublic_toavec--public-to-workspaceou--public-to-member <user-id>.--visibility private|workspaceest l'ancienne forme, convertie en--permission-mode; si les deux sont fournis,--permission-model'emporte.
Daemon et runtimes
multica daemon start
multica daemon stop
multica daemon restart
multica daemon status --output json
multica daemon logs --follow
multica runtime list
multica runtime rename <runtime-id> "Office Mac"
multica runtime usage <runtime-id>
multica runtime activity <runtime-id>multica daemon autostart enable
multica runtime usage <runtime-id> --days 30
multica runtime update <runtime-id> --target-version <version> --wait
multica runtime profile create --display-name "Wrapper Claude interne" \
--command-name ccms --runtime-type claudedaemon autostart enregistre le profil courant pour qu'il démarre à l'ouverture de session ; les différences entre plateformes sont décrites dans Démarrage à l'ouverture de session. runtime usage couvre 90 jours par défaut, et --days va jusqu'à 365. runtime update demande au daemon de cette machine de mettre sa CLI à jour vers la version indiquée ; --wait attend la fin de la mise à jour. runtime profile create indique l'outil compatible avec --runtime-type (l'ancien --protocol-family fonctionne encore) ; les arguments fixes ne se définissent pour l'instant que dans l'application web.
La suppression d'un runtime auquel des agents actifs sont encore liés est refusée par défaut. multica runtime delete <id> --cascade dissocie ces agents, préserve leur configuration et leur historique, et annule leurs exécutions actives.
Consultez Daemon et runtimes pour son fonctionnement et les profils personnalisés.
Projets, espaces de travail et automatisations
multica project create --title "Campagne d'été" --lead "Lei Li" \
--repo https://github.com/acme/campaign-site
multica project resource add <project-id> --type github_repo \
--url https://github.com/acme/brand-assets --default-branch-hint main
multica workspace create --name "Opérations" --slug ops --issue-prefix OPS
multica workspace update --context-stdin < team-context.md
multica autopilot create --title "Rapport de ventes hebdomadaire" --agent "Assistant ops" \
--mode create_issue --issue-title-template "Rapport de ventes {{date}}"
multica autopilot trigger-add <autopilot-id> --cron "0 9 * * 1" --timezone Europe/Paris--leadprend le nom d'un membre ou d'un agent.--default-branch-hintindique seulement à l'agent la branche par défaut du dépôt ; il ne change pas de branche.- Le
--contextd'un espace de travail est fourni à tous ses agents.--slugne peut plus être modifié après la création.--issue-prefixest mis en majuscules ; le changer renumérote toutes les tâches existantes, et les anciens identifiants cités ailleurs ne mènent plus nulle part. --issue-title-templatene remplace que{{date}}(UTC,YYYY-MM-DD) et refuse tout autre{{...}}. Le--timezoned'un déclencheur planifié vaut UTC par défaut.
Vue d'ensemble des commandes
| Commande | Rôle |
|---|---|
issue | Créer, mettre à jour, assigner et rechercher des tâches ; gérer les commentaires, les abonnés, les étiquettes, les propriétés, les réveils, la chronologie et les exécutions |
project | Gérer les projets et leurs ressources |
label, property | Gérer les étiquettes et les propriétés personnalisées de l'espace de travail |
view | Lire les vues enregistrées et lister les tâches qu'une vue affiche |
agent, skill, squad | Gérer les agents, les skills et les squads |
autopilot | Gérer les automatisations, les déclencheurs et l'historique des exécutions |
workspace | Créer, consulter et changer d'espace de travail, et inviter des membres |
repo | Gérer les dépôts de l'espace de travail et les extraire localement |
daemon, runtime | Démarrer et arrêter le daemon local ; consulter et gérer les runtimes |
attachment | Envoyer ou télécharger des pièces jointes |
user profile | Consulter ou mettre à jour le profil de l'utilisateur actuel |
auth, login, setup | Se connecter, vérifier l'état de l'authentification et initialiser une connexion |
config | Consulter ou modifier la configuration locale du profil CLI actuel |
update, version | Mettre à jour le CLI ou afficher la version |
multica chat lit la session de messagerie externe qu'un agent traite actuellement ; elle sert surtout aux agents des intégrations de messagerie et n'est pas une commande générale pour parcourir n'importe quelle discussion de l'espace de travail.
ID et formats de sortie
Les tâches utilisent des clés comme MUL-123 ou des UUID complets ; les préfixes courts d'UUID ne sont pas acceptés.
Pour les autres ressources, les commandes list affichent généralement des ID courts copiables et prennent en charge --full-id pour obtenir l'UUID complet. Lorsqu'un ID court est ambigu, le CLI demande davantage de caractères ou l'UUID complet. Les ID courts d'exécution exigent aussi --issue pour identifier la tâche à laquelle ils appartiennent.
De nombreuses commandes prennent en charge une sortie structurée :
multica issue list --output json
multica agent list --output jsonLes scripts doivent utiliser la sortie JSON plutôt que d'analyser les tableaux destinés au terminal. Les formats de sortie et les options de pagination pris en charge par chaque commande sont définis par multica <command> --help.
Profils et configuration
La configuration par défaut se trouve dans ~/.multica/config.json. Utilisez --profile <name> pour isoler un ensemble distinct d'adresse de serveur, de jeton, d'espace de travail par défaut et d'état du daemon :
multica setup self-host --profile staging \
--server-url https://api.staging.example.com \
--app-url https://app.staging.example.com
multica issue list --profile stagingLes profils nommés se trouvent dans ~/.multica/profiles/<name>/config.json. Inspectez les valeurs actuelles :
multica config show
multica config show --profile stagingNe définissez pas MULTICA_DAEMON_PORT dans le shell hôte, le service Compose ou le point d'entrée du conteneur qui démarre un daemon. Le daemon hôte déduit son port de contrôle de santé de --profile et injecte lui-même cette variable dans les exécutions d'agent. Supprimez complètement la variable des anciens environnements de démarrage : sinon, les versions 0.4.22 et 0.4.23 prennent ce shell pour une exécution gérée et refusent la connexion. Les versions plus récentes permettent à la connexion humaine protégée et à daemon status de se rétablir lorsque le port est le seul signal d'exécution, mais les commandes API ordinaires et celles qui résolvent un profil restent volontairement bloquées (fail-closed) tant que la variable n'est pas supprimée.
Lorsque le CLI tourne au sein d'une exécution d'agent gérée par le daemon, il ne charge ni ne modifie ces fichiers de profil qui appartiennent à l'utilisateur humain. Les commandes de l'API Multica s'authentifient avec l'identifiant limité à l'exécution que le daemon injecte. config show et config set utilisent un état privé, local à l'exécution ; les commandes humaines ou locales comme login, logout, setup, workspace switch, les modifications de chemin des profils de runtime locaux, daemon start / stop / restart, daemon logs et daemon probe-runtimes sont indisponibles. Dans ce contexte, auth status n'affiche aucun élément de jeton.
daemon status et daemon disk-usage restent disponibles pour qu'un agent puisse inspecter le runtime qui l'héberge, dans les limites de ce runtime : status interroge le port de contrôle de santé injecté par le daemon, et disk-usage analyse la racine des répertoires de travail injectée par le daemon. Aucune des deux n'accepte --profile ; disk-usage refuse aussi --all-profiles et --workspaces-root, et sa colonne STATUS reste vide, car la renseigner exigerait le jeton enregistré de l'utilisateur humain. Utilisez du et df pour tout ce qui sort de ce périmètre.
Cela protège la résolution implicite des profils du CLI Multica tout en préservant les variables HOME et XDG habituelles qu'utilisent les outils des autres fournisseurs. Ce n'est pas une frontière du système de fichiers au niveau de l'OS : des processus qui tournent sous le même utilisateur système peuvent toujours ouvrir un chemin connu explicitement. Utilisez un utilisateur dédié, un conteneur, une VM ou une isolation équivalente lorsque cette garantie plus forte est nécessaire.
Les fichiers de configuration du CLI contiennent des jetons qui permettent d'accéder à Multica en votre nom. Ne les commitez pas dans un dépôt, ne les envoyez pas dans des journaux et ne les partagez avec personne.
Référence des commandes
Les tableaux ci-dessous couvrent toutes les commandes de premier niveau actuelles, regroupées comme le CLI lui-même les regroupe. Toutes les commandes acceptent les options globales --server-url, --workspace-id, --profile et --debug. --output est déclarée commande par commande, et le format par défaut varie : les commandes list affichent par défaut un tableau, tandis que les commandes get et create renvoient le plus souvent du JSON. Les options complètes sont définies par multica <command> --help.
Core
| Commande | Sous-commande | Rôle | Options principales |
|---|---|---|---|
issue | list | Lister les tâches | --status, --priority, --assignee, --project, --updated-since / --updated-until (bornes RFC3339 à fournir ensemble), --metadata (répétable), --property (répétable, "Name=Value" ; __none__ correspond à une valeur non définie), --limit, --offset, --sort (y compris property:<name-or-id>), --full-id, --resolve-properties (JSON uniquement ; lignes avec les noms de propriété, d'option et de membre à côté des ID enregistrés), --fields (JSON uniquement ; champs à conserver, séparés par des virgules) |
get <id> | Afficher une tâche | --resolve-properties (JSON uniquement ; lignes avec les noms de propriété, d'option et de membre à côté des ID enregistrés) | |
create | Créer une tâche | --title (obligatoire), --description / --description-stdin / --description-file, --pr-auto-complete on/off, --status, --priority, --assignee, --parent, --stage, --project, --start-date, --due-date, --attachment (répétable), --property (répétable), --allow-duplicate (crée même si une tâche ouverte porte le même titre) | |
update <id> | Mettre à jour les champs d'une tâche | Mêmes champs que create, plus --position, --no-start, --duplicate-of | |
assign <id> | Assigner ou désassigner | --to (correspondance approximative sur le nom parmi les membres, les agents et les squads), --to-id, --unassign, --no-start | |
status <id> <status> | Changer le statut | --no-start, --duplicate-of | |
reorder <id> | Déplacer au sein d'une colonne | ||
search <query> | Rechercher des tâches | --limit, --include-closed | |
children <id> | Lister les sous-tâches regroupées par étape | ||
pull-requests <id> | Lister les PR associées | ||
comment list/add/update/delete/resolve/unresolve | Gérer les commentaires | add : --content / --content-stdin / --content-file, --parent, --attachment ; update : --expected-revision (obligatoire), --content / --content-stdin / --content-file ; list : --since, --thread, --tail, --recent, --roots-only, --summary, --compact, --full | |
timeline <id> | Lister l'activité et les commentaires dans l'ordre chronologique | --action (répétable), --activity-only, --since, --tail | |
wakeup events/list/get/create/update/disable/trigger/delete/checkin/runs | Gérer les réveils de tâche ; voir Réveils de tâche | create / update : --agent-id, --kind (event, at, every, cron), --event, --at / --after, --every, --cron, --timezone, conditions --until-*, --expires-in / --expires-at, --instruction / --instruction-file ; checkin : --note | |
subscriber list/add/remove <issue-id> | Gérer les abonnés | --user, --user-id (par défaut, l'utilisateur actuel) | |
label list/add/remove <issue-id> | Gérer les étiquettes d'une tâche | ||
metadata list/get/set/delete <issue-id> | Gérer les métadonnées clé-valeur au niveau de la tâche | ||
property list/set/unset <issue-id> | Définir les valeurs des propriétés personnalisées | set : --name, --value (actor / multi_actor acceptent un nom de membre, un e-mail ou un ID) | |
runs <issue-id> | Afficher l'historique des exécutions | --full-id | |
run-messages <task-id> | Afficher les messages d'une exécution | --since, --issue | |
usage <issue-id> | Afficher la consommation de tokens agrégée | ||
rerun-task <run-id> | Relancer une exécution précise avec son agent et son contexte de déclenchement d’origine | --issue, --fresh | |
cancel-task <task-id> | Annuler une exécution en cours ou en file d'attente | --issue | |
project | list/get/create/update/delete | Gérer les projets | create : --title (obligatoire), --lead, --status, --icon, --start-date, --due-date, --repo (répétable) |
status <id> <status> | Changer le statut d'un projet | ||
resource list/add/update/remove | Gérer les ressources d'un projet | --type, --url, --default-branch-hint, --ref, --local-path, --daemon-id, --execution-mode (in_place / worktree pour un répertoire local) | |
label | list/get/create/update/delete | Gérer les étiquettes de l'espace de travail | list : --resource-type (issue ou skill), --full-id ; create : --name, --color, --resource-type (issue ou skill), --description |
property | list/get/create/update/archive/unarchive | Gérer les propriétés personnalisées de l'espace de travail | create : --name, --type (text, number, select, multi_select, date, checkbox, url, actor, multi_actor), --option (répétable, types select uniquement) ; list : --include-archived ; le type ne peut plus être modifié après la création |
view | list/get/issues | Lire les vues que vous pouvez ouvrir (les vôtres et celles partagées avec l'espace de travail) ; issues liste les tâches qu'une vue affiche, dans son ordre enregistré, avec tous ses filtres appliqués par le serveur. Pendant l'exécution d'un agent, les vues et les conditions « moi » sont celles du propriétaire du runtime | <view> accepte un ID, un préfixe d'ID ou le nom exact ; list : --scope (workspace, my, project), --project, --full-id ; issues : --limit (100 au maximum), --cursor (le next_cursor de la page précédente), --today (le jour de référence des filtres d'échéance relatifs ; aujourd'hui par défaut), --fields (JSON uniquement), --full-id |
agent | list/get/create/update/archive/restore | Gérer les agents | --name, --runtime-id (obligatoire pour create), --instructions, --conversation-starters, --model, --thinking-level, --custom-env / --custom-env-file / --custom-env-stdin (create uniquement), --custom-args, --mcp-config / --mcp-config-file / --mcp-config-stdin, --permission-mode, --visibility (ancienne forme), --max-concurrent-tasks |
copy <agent-id> | Copier dans un nouvel agent ; l'original reste intact | --name (par défaut, le nom d'origine suivi de (copy)), --runtime-id (copier vers un autre runtime exige aussi --model), --no-skills ; la configuration secrète comme custom_env, mcp_config et runtime_config n'est pas copiée — fournissez-la à nouveau avec les mêmes options que pour create | |
tasks <id> | Afficher les exécutions d'un agent | ||
avatar <id> | Envoyer un avatar | ||
env get/set <agent-id> | Lire et écrire les variables d'environnement personnalisées (propriétaire de l'agent ou owner/admin de l'espace de travail ; chaque lecture est enregistrée) | set : --custom-env / --custom-env-file / --custom-env-stdin ; remplace l'ensemble, et les clés dont la valeur est **** gardent leur valeur | |
skills list/set/add <agent-id> | Gérer les skills rattachés | --skill-ids (set remplace toute la liste, add ajoute à la suite) | |
mcp list/add/enable/disable/remove <agent-id> | Assigner des serveurs MCP de l'espace de travail à cet agent | Récupérez l'ID du serveur avec workspace mcp list. Une entrée de la bibliothèque n'a aucun effet tant qu'elle n'est pas ajoutée ici ; disable cesse de l'envoyer sans supprimer l'assignation | |
autopilot | list/get/create/update/delete | Gérer les automatisations | create : --title, --agent, --mode (tous obligatoires), --description, --issue-title-template, --project, --subscriber (répétable) |
trigger <id> | Déclencher une exécution manuellement | ||
runs <id> | Afficher l'historique des exécutions | ||
trigger-add/trigger-update/trigger-delete/trigger-rotate-url | Gérer les déclencheurs de planification et webhook | trigger-add : --kind (schedule ou webhook), --cron, --timezone (UTC par défaut), --label | |
workspace | list/get/create/update/switch | Gérer les espaces de travail ; switch définit l'espace de travail par défaut du profil actuel | create : --name, --slug (tous deux obligatoires), --issue-prefix, --description, --context / --context-stdin ; update modifie les mêmes champs, sauf le slug |
mcp list/add/update/remove | Gérer la bibliothèque de serveurs MCP de l'espace de travail | Les écritures sont réservées aux propriétaires et administrateurs. Un serveur ajouté ici n'est assigné à aucun agent — attribuez-le à un agent avec multica agent mcp add. list n'affiche que les noms et les transports ; l'entrée enregistrée est en écriture seule et n'est jamais renvoyée. --server-config-file / --server-config-stdin gardent les jetons hors de l'historique du shell | |
member list/invite <email> | Consulter les membres, envoyer des invitations | invite : --role (member ou admin, member par défaut) | |
repo | list/add/remove/checkout | Gérer les dépôts de l'espace de travail et les extraire localement | --url (répétable) ; checkout : --ref |
skill | list/get/create/update/delete | Gérer les skills | |
import | Importer un skill depuis une URL ou un fichier local | --url / --file, --on-conflict (fail, overwrite, rename, skip ; fail par défaut) | |
search <query> | Rechercher des skills | ||
files list/upsert/delete <skill-id> | Gérer les fichiers d'un skill | ||
label list/add/remove <skill-id> | Gérer les étiquettes d'un skill | add / remove : <label-id> accepte un UUID complet ou un préfixe court | |
squad | list/get/create/update/delete | Gérer les squads (delete archive) | |
member list/add/set-role/remove | Gérer les membres d'un squad | ||
activity <issue-id> <outcome> | Enregistrer une évaluation du chef | ||
chat | history, thread [id] | Lire la session de messagerie externe qu'un agent traite actuellement | --limit, --before |
Runtime
| Commande | Sous-commande | Rôle | Options principales |
|---|---|---|---|
daemon | start | Démarrer le daemon local | --foreground, --device-name, --runtime-name, --workspaces-root, --poll-interval, --heartbeat-interval, --agent-timeout (0 signifie aucune limite), --max-concurrent-tasks, --no-auto-update ; chacune a une variable d'environnement MULTICA_* correspondante |
stop / status / restart | Arrêter, vérifier l'état, redémarrer (restart accepte les mêmes options que start) | ||
logs | Afficher les journaux du daemon | --follow, --lines | |
disk-usage | Afficher l'utilisation du disque local | --by-workspace, --by-task, --top | |
autostart enable/disable/status | Enregistrer ou retirer le démarrage à l'ouverture de session pour le profil courant | status : --output | |
runtime | list/usage/activity/update/rename/delete | Consulter et gérer les runtimes | usage : --days (90 par défaut, 365 au maximum) ; update : --target-version (obligatoire), --wait ; delete : --cascade (dissocie les agents liés, préserve leurs données et annule leurs exécutions) |
profile list/create/update/delete | Gérer les profils de runtime personnalisés | create : --display-name, --command-name (tous deux obligatoires), --runtime-type (ou l'ancien --protocol-family), --description ; update : --enabled | |
profile set-path/unset-path <profile-id> | Fixer le chemin d'un exécutable local (local uniquement, jamais envoyé au serveur) |
Additional
| Commande | Sous-commande | Rôle | Options principales |
|---|---|---|---|
auth | status / logout | Vérifier l'état de l'authentification ; logout supprime seulement le jeton enregistré localement et ne le révoque pas côté serveur | |
user | profile get/update | Consulter ou mettre à jour le profil de l'utilisateur actuel | |
login | — | Se connecter via le navigateur et configurer automatiquement tous les espaces de travail | --token (demande la saisie de façon interactive dans le terminal lorsque l'option est passée sans valeur) |
setup | cloud (par défaut), self-host | Enregistrer l'adresse du serveur, finaliser la connexion et démarrer le daemon | self-host : --server-url, --app-url, --port, --frontend-port |
attachment | download <attachment-id>, upload <path> | Télécharger ou envoyer des pièces jointes | download : --output-dir ; upload : --task |
config | show, set <key> <value> | Consulter ou modifier la configuration locale du profil actuel | Priorité : options de ligne de commande > variables d'environnement > config.json > valeurs par défaut intégrées ; définissez une chaîne vide pour effacer une valeur |
update | — | Mettre à jour le CLI vers la dernière version | |
version | — | Afficher les informations de version | --output (text ou json) |
Piloter Multica depuis un autre agent de codage
Si l'essentiel de votre travail se passe déjà dans Codex, Claude Code ou Cursor, vous pouvez piloter Multica depuis ces outils au lieu de basculer vers un terminal. Le skill Multica CLI apprend à ces agents à utiliser les commandes de cette page en toute sécurité : lire les tâches et les fils de commentaires sans gaspiller de tokens, écrire les commentaires via un fichier, et gérer les effets de bord qu'entraînent les mentions, les changements de statut et les assignations.
Il passe entièrement par votre CLI authentifié et n'accorde aucun accès qui lui soit propre : les permissions proviennent toujours de votre connexion, du profil sélectionné et de l'espace de travail. Il nécessite le CLI v0.4.26 ou ultérieur. Le README du dépôt explique l'installation via la marketplace de plugins de Claude Code, l'installateur de skills de Codex, Cursor et tout autre outil qui charge des instructions Markdown.
Étapes suivantes
- Skill Multica CLI — piloter Multica depuis Codex, Claude Code ou Cursor.
- Authentification et jetons — créer, renouveler et révoquer des PAT.
- Dépannage — diagnostiquer les erreurs de commande et les exécutions qui ne démarrent jamais.
- Créer et configurer un agent — la sémantique complète de chaque champ de
agent create.
Dépannage
Diagnostiquez les problèmes courants de connexion, d'exécution, de mises à jour en temps réel, d'e-mail et de services auto-hébergés.
Authentification et jetons
Comprendre les sessions de connexion du navigateur, les jetons d'accès personnels et les identifiants temporaires qu'utilisent les agents pendant les exécutions.