asnx: Asana CLI
asnx <entidad> <acción> [<gid>] [--banderas...]
El CLI siempre es plano: asnx <entidad> <acción>. Las acciones de sub-recursos y verbos se mantienen explícitas, por ejemplo asnx tasks subtasks, asnx tasks create-subtasks y asnx tasks add-followers.
Usa asnx describe [<entidad> [<acción>]] para introspección del esquema.
Autenticación
Resolución: --account <nombre> > variable de entorno ASANA_TOKEN > cuenta única almacenada.
asnx auth status verifica el token resuelto contra la API; úsalo para diagnosticar errores 401.
Entrada
Las escrituras aceptan banderas individuales o un cuerpo JSON en bruto. --json gana en caso de conflicto.
asnx tasks create --json '{"name":"corrección","projects":["def"]}'
--json espera solo los campos de solicitud en bruto, no un envoltorio completo de Asana como { "data": ... }.
Salida
Los comandos exitosos emiten un envoltorio JSON con meta y data:
{
"meta": {
"command": "tasks.list",
"status": 200,
"nextPage": null
},
"data": [ ... ]
}
meta.commandes siempreentidad.acción(un punto), por ejemplotasks.list,tasks.subtasks, oproject-briefs.create-for-project.dataes la carga útil de Asana sin envolver: objeto para recursos individuales, arreglo para listas.meta.nextPagees un desplazamiento de paginación (cadena) onull. Pásalo como--offset.
Los errores van a stderr como {"error":{"status":...,"message":...,"help":...}}. status es null para errores locales (uso, transporte). El código de salida siempre es 1 en caso de error.
Reglas
- Usa
--dry-runpara previsualizar escrituras antes de enviarlas. - Usa
--opt-fieldsen solicitudes GET para mantener las respuestas pequeñas. - La paginación es manual: verifica
meta.nextPage, pásalo como--offset. - No adivines GID, consulta primero. Empieza con
asnx workspaces list, luego por ejemploasnx tasks search <workspace-gid> --text "corrección". - Si los comandos de entidad aparecen como desconocidos, falta la caché del esquema: ejecuta
asnx schema update. - Los filtros con puntos de Asana se mantienen con puntos en el CLI, por ejemplo
--projects.anyo--due-on.before.
Casos especiales
start_onrequieredue_on: envíalos siempre juntos.mees un alias posicional de GID, no una acción. Usausers get me, nousers me.tasks for-projectdevuelve todas las tareas, incluidas las completadas, por defecto. Para obtener solo tareas incompletas, pasa--completed-since <timestamp-reciente>(por ejemplo, ahora); Asana entonces devuelve tareas que están incompletas o que se completaron desde ese momento.tasks duplicateyprojects duplicateno transfieren todas las asociaciones. Una tarea duplicada vuelve sin membresía de proyecto (projects: []) a menos que pases--includenombrando los elementos a copiar, por ejemplo--include projects,subtasks,assignee.stories for-taskystories for-goaldevuelven comentarios y eventos del sistema juntos. Los comentarios son las entradas con"type": "comment"; filtra del lado del cliente.tasks searches eventualmente consistente. Verifica escrituras recientes contasks getotasks for-project, no consearch.attachments createes multipart en el lado de Asana y este CLI solo maneja JSON; la acción se muestra pero siempre falla. Usa la API sin procesar para cargas de archivos.project-briefs create-for-projectpuede rechazar--textplano conRich text should be wrapped in <body> tag.Si eso ocurre, reintenta con--html-text '<body>...</body>'.<entidad> remove-members --members me(portfolios, projects, goals, teams) revoca tu propio acceso.