asncli_skill

This skill helps you manage Asana projects and tasks from the command line with quick, accurate commands and parseable output.

Shell

2

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill michalvavra/agents --skill asncli

SKILL.md1.0 KB

Overview

This skill provides a command-line interface to Asana for managing workspaces, projects, custom fields, and tasks. It exposes common Asana operations—authentication, listing and retrieving projects, creating and updating tasks—designed for scripting and terminal workflows. Output can be made machine-parseable with JSON for automation.

How this skill works

The CLI wraps Asana API calls into simple commands like auth, projects, custom-fields, and tasks. Commands support flags for workspace and project selection, filtering (assignee, due dates, completed state), and produce human-readable or JSON output. Use --help on any command to see options and --json to get parseable results for pipelines.

When to use it

Quickly create, update, or inspect tasks from a terminal or shell script.
Automate task reporting or export Asana data in CI/CD or scheduled jobs.
Manage multiple workspaces or projects without the web UI.
Integrate Asana operations into local developer workflows or task-sync scripts.
Run searches and filtered lists to feed dashboards or notifications.

Best practices

Authenticate once with asn auth login and verify with asn auth status before scripting.
Use --json when you intend to parse output programmatically.
Set a default workspace with asn config set-workspace to avoid repeating flags.
Limit results with --limit when listing to reduce payload and speed up scripts.
Use explicit IDs (GIDs) for projects, tasks, and assignees to avoid ambiguity.

Example use cases

Create a new task from a commit hook: asn tasks create --name="Fix bug" --project=GID --assignee=me --notes="Linked to commit"
Generate a daily list of overdue tasks for a team by running asn tasks search with --due-on-before and --assignee-any
Sync custom field options into another system by exporting with asn custom-fields list --workspace=GID --json
Fetch a project summary for a stand-up script using asn projects list and asn tasks list --project=GID --limit=50 --json
Mark tasks as completed from a script: asn tasks update <gid> --completed

FAQ

Add the --json flag to most commands to receive JSON suitable for parsing.

Can I avoid passing workspace for every command?

Yes. Run asn config set-workspace to set a default workspace for subsequent commands.