asnx: CLI Asana
asnx <entidade> <ação> [<gid>] [--flags...]
A CLI é sempre plana: asnx <entidade> <ação>. Ações de sub-recursos e verbos permanecem explícitas, por exemplo asnx tasks subtasks, asnx tasks create-subtasks, e asnx tasks add-followers.
Use asnx describe [<entidade> [<ação>]] para introspecção de esquema.
Autenticação
Resolução: --account <nome> > variável de ambiente ASANA_TOKEN > conta armazenada única.
asnx auth status verifica o token resolvido junto à API; use-o para diagnosticar erros 401.
Entrada
Gravações aceitam flags individuais ou um corpo JSON bruto. --json vence em caso de conflito.
asnx tasks create --json '{"name":"correção","projects":["def"]}'
--json espera apenas campos brutos da requisição, não um envelope completo { "data": ... } do Asana.
Saída
Comandos bem-sucedidos emitem um envelope JSON com meta e data:
{
"meta": {
"command": "tasks.list",
"status": 200,
"nextPage": null
},
"data": [ ... ]
}
meta.commandé sempreentidade.ação(um ponto), ex.:tasks.list,tasks.subtasks, ouproject-briefs.create-for-project.dataé o payload não encapsulado do Asana: objeto para recursos únicos, array para listas.meta.nextPageé um offset de paginação (string) ounull. Passe-o como--offset.
Erros vão para stderr como {"error":{"status":...,"message":...,"help":...}}. status é null para erros locais (uso, transporte). O código de saída é sempre 1 em caso de erro.
Regras
- Use
--dry-runpara pré-visualizar gravações antes de enviá-las. --opt-fieldsem requisições GET para manter as respostas enxutas.- Paginação é manual: verifique
meta.nextPage, passe como--offset. - Não adivinhe GIDs, consulte primeiro. Comece com
asnx workspaces list, depois, ex.:asnx tasks search <workspace-gid> --text "correção". - Se comandos de entidade forem desconhecidos, o cache de esquema está faltando: execute
asnx schema update. - Filtros pontilhados do Asana permanecem pontilhados na CLI, por exemplo
--projects.anyou--due-on.before.
Pegadinhas
start_onrequerdue_on: envie ambos juntos.meé um alias de GID posicional, não uma ação. Useusers get me, nãousers me.tasks for-projectretorna todas as tarefas, incluindo as concluídas, por padrão. Para obter apenas tarefas incompletas, passe--completed-since <carimbo-de-tempo-recente>(ex.: agora); o Asana então retorna tarefas que estão incompletas ou foram concluídas desde aquele momento.tasks duplicateeprojects duplicatenão transferem todas as associações. Uma tarefa duplicada retorna sem associação a projetos (projects: []) a menos que você passe--includenomeando os elementos a copiar, ex.:--include projects,subtasks,assignee.stories for-taskestories for-goalretornam comentários e eventos do sistema juntos. Comentários são as entradas com"type": "comment"; filtre no lado do cliente.tasks searché eventualmente consistente. Verifique gravações recentes comtasks getoutasks for-project, não comsearch.attachments createé multipart no lado do Asana e esta CLI é apenas JSON; a ação aparece mas sempre falha. Use a API bruta para uploads de arquivos.project-briefs create-for-projectpode rejeitar--textsimples comRich text should be wrapped in <body> tag.Se isso acontecer, tente novamente com--html-text '<body>...</body>'.<entidade> remove-members --members me(portfolios, projetos, metas, equipes) revoga seu próprio acesso.