asnx: Asana-CLI
asnx <entity> <action> [<gid>] [--flags...]
Die CLI ist immer flach: asnx <entity> <action>. Sub-Ressourcen- und Verb-Aktionen bleiben explizit, z. B. asnx tasks subtasks, asnx tasks create-subtasks und asnx tasks add-followers.
Verwende asnx describe [<entity> [<action>]] für die Schema-Introspection.
Authentifizierung
Auflösung: --account <name> > ASANA_TOKEN-Umgebungsvariable > einzelnes gespeichertes Konto.
asnx auth status überprüft das aufgelöste Token gegen die API; verwende es, um 401-Fehler zu diagnostizieren.
Eingabe
Schreiboperationen akzeptieren entweder einzelne Flags oder einen rohen JSON-Textkörper. --json gewinnt bei Konflikten.
asnx tasks create --json '{"name":"bugfix","projects":["def"]}'
--json erwartet nur die rohen Anfragefelder, nicht den vollständigen Asana-{ "data": ... }-Umschlag.
Ausgabe
Erfolgreiche Befehle geben einen JSON-Umschlag mit meta und data aus:
{
"meta": {
"command": "tasks.list",
"status": 200,
"nextPage": null
},
"data": [ ... ]
}
meta.commandist immerentity.action(ein Punkt), z. B.tasks.list,tasks.subtasksoderproject-briefs.create-for-project.dataist die entpackte Asana-Nutzlast: Objekt für einzelne Ressourcen, Array für Listen.meta.nextPageist ein Paginierungs-Offset (String) odernull. Übergib es als--offset.
Fehler gehen auf stderr als {"error":{"status":...,"message":...,"help":...}}. status ist null für lokale Fehler (Verwendung, Transport). Der Exit-Code ist bei Fehlern immer 1.
Regeln
- Verwende
--dry-run, um Schreibvorgänge vor dem Senden in der Vorschau anzuzeigen. - Verwende
--opt-fieldsbei GET-Anfragen, um Antworten klein zu halten. - Paginierung erfolgt manuell: Überprüfe
meta.nextPageund übergib es als--offset. - Rate keine GIDs, frage zuerst ab. Beginne mit
asnx workspaces list, dann z. B.asnx tasks search <workspace-gid> --text "bugfix". - Falls Entitätsbefehle als unbekannt zurückkommen, fehlt der Schema-Cache: Führe
asnx schema updateaus. - Gepunktete Asana-Filter bleiben auf der CLI gepunktet, z. B.
--projects.anyoder--due-on.before.
Fallstricke
start_onerfordertdue_on: Sende beide immer zusammen.meist ein positioneller GID-Alias, keine Aktion. Verwendeusers get me, nichtusers me.tasks for-projectgibt standardmäßig alle Aufgaben zurück, einschließlich abgeschlossener. Um nur unvollständige Aufgaben zu erhalten, übergib--completed-since <aktueller-Zeitstempel>(z. B. jetzt); Asana gibt dann Aufgaben zurück, die unvollständig sind oder seit diesem Zeitpunkt abgeschlossen wurden.tasks duplicateundprojects duplicateübertragen nicht jede Verknüpfung. Eine duplizierte Aufgabe wird ohne Projektmitgliedschaft zurückgegeben (projects: []), es sei denn, du übergibst--includemit den zu kopierenden Elementen, z. B.--include projects,subtasks,assignee.stories for-taskundstories for-goalgeben Kommentare und Systemereignisse zusammen zurück. Kommentare sind die Einträge mit"type": "comment"; filtere client-seitig.tasks searchist nur eventuell konsistent. Überprüfe aktuelle Schreibvorgänge mittasks getodertasks for-project, nicht mitsearch.attachments createist auf Asana-Seite Multipart und diese CLI ist nur JSON; die Aktion wird angezeigt, schlägt aber immer fehl. Verwende die rohe API für Datei-Uploads.project-briefs create-for-projectkann einfaches--textmitRich text sollte in ein <body>-Tag eingewickelt sein.ablehnen. Falls das passiert, wiederhole mit--html-text '<body>...</body>'.<entity> remove-members --members me(Portfolios, Projekte, Ziele, Teams) entzieht deinen eigenen Zugriff.