asnx : CLI Asana
asnx <entité> <action> [<gid>] [--drapeaux...]
La CLI est toujours plate : asnx <entité> <action>. Les actions de sous-ressource et de verbe restent explicites, par exemple asnx tasks subtasks, asnx tasks create-subtasks et asnx tasks add-followers.
Utilisez asnx describe [<entité> [<action>]] pour l'introspection du schéma.
Authentification
Résolution : --account <nom> > variable d'environnement ASANA_TOKEN > compte stocké unique.
asnx auth status vérifie le jeton résolu auprès de l'API ; utilisez-le pour diagnostiquer les erreurs 401.
Entrée
Les écritures acceptent soit des drapeaux individuels, soit un corps JSON brut. --json l'emporte en cas de conflit.
asnx tasks create --json '{"name":"bugfix","projects":["def"]}'
--json attend uniquement les champs bruts de la requête, pas une enveloppe Asana complète { "data": ... }.
Sortie
Les commandes réussies émettent une enveloppe JSON avec meta et data :
{
"meta": {
"command": "tasks.list",
"status": 200,
"nextPage": null
},
"data": [ ... ]
}
meta.commandest toujoursentité.action(un point), par exempletasks.list,tasks.subtasks, ouproject-briefs.create-for-project.dataest la charge utile Asana désenveloppée : objet pour les ressources uniques, tableau pour les listes.meta.nextPageest un décalage de pagination (chaîne) ounull. Passez-le en tant que--offset.
Les erreurs vont sur stderr sous la forme {"error":{"status":...,"message":...,"help":...}}. status est null pour les erreurs locales (utilisation, transport). Le code de sortie est toujours 1 en cas d'erreur.
Règles
- Utilisez
--dry-runpour prévisualiser les écritures avant de les envoyer. - Utilisez
--opt-fieldssur les requêtes GET pour garder les réponses légères. - La pagination est manuelle : vérifiez
meta.nextPage, passez-le en tant que--offset. - Ne devinez pas les GID, interrogez d'abord. Commencez par
asnx workspaces list, puis par exempleasnx tasks search <workspace-gid> --text "bugfix". - Si les commandes d'entité reviennent comme inconnues, le cache de schéma est manquant : exécutez
asnx schema update. - Les filtres Asana pointés restent pointés sur la CLI, par exemple
--projects.anyou--due-on.before.
Pièges
start_onnécessitedue_on: envoyez toujours les deux ensemble.meest un alias de GID positionnel, pas une action. Utilisezusers get me, pasusers me.tasks for-projectrenvoie toutes les tâches, y compris les tâches terminées, par défaut. Pour obtenir uniquement les tâches incomplètes, passez--completed-since <timestamp-récent>(par exemple maintenant) ; Asana renvoie alors les tâches qui sont incomplètes ou qui ont été terminées depuis ce moment.tasks duplicateetprojects duplicatene transfèrent pas toutes les associations. Une tâche dupliquée revient sans appartenance à un projet (projects: []) sauf si vous passez--includeen nommant les éléments à copier, par exemple--include projects,subtasks,assignee.stories for-tasketstories for-goalrenvoient les commentaires et les événements système ensemble. Les commentaires sont les entrées avec"type": "comment"; filtrez côté client.tasks searchest éventuellement cohérent. Vérifiez les écritures récentes avectasks getoutasks for-project, passearch.attachments createest multipart du côté d'Asana et cette CLI est uniquement JSON ; l'action apparaît mais échoue toujours. Utilisez l'API brute pour les téléchargements de fichiers.project-briefs create-for-projectpeut rejeter le--textsimple avecRich text should be wrapped in <body> tag.Si cela se produit, réessayez avec--html-text '<body>...</body>'.<entité> remove-members --members me(portfolios, projets, objectifs, équipes) révoque votre propre accès.