feat: non-interactive CLI support with new commands

[jtsternberg]

Note

These changes are maintained in a fork: jtsternberg/asana-cli
If you're looking for non-interactive CLI support, --json output, tasks delete, projects sections, or Claude Code plugin integration, check it out.

Summary

• Add non-interactive flag support to tasks create, tasks update, and tasks view — all commands work without interactive prompts when flags/args are provided
• Add --json flag to tasks list, tasks search, and tasks view for machine-readable structured output
• Show task IDs in list and search text output for scripting workflows
• Add --limit flag to tasks search, consistent with tasks list
• Remove silent --assignee me default from search that hid results from other assignees
• Rename --creator-any to --creator for natural flag naming
• Add tasks delete command
• Add projects sections command to list sections in a project
• Add Task.AddFollowers API method (uses /tasks/{id}/addFollowers endpoint)
• Include a Claude Code plugin with skills, commands, agent, and settings for AI-assisted Asana task management
• Add Claude Code Plugin section to README
• Expand search skill documentation with full flags table and list-vs-search guidance

Changes

Task create (tasks create)

New flags: --name/-n, --assignee/-a, --project/-p, --section/-s, --due/-d, --description/-m, --followers/-f, --non-interactive. Auto-detects non-interactive mode when name+assignee+project are all provided. Falls back to interactive prompts without flags.

Task update (tasks update)

Accepts optional task ID as first argument. With ID: uses flags (--name, --description, --due, --assignee, --followers, --complete, --non-interactive). Without ID: falls back to interactive mode.

Task view (tasks view)

Accepts optional task ID argument for direct viewing. Shows permalink URL in output. Supports --json for structured output. Without ID, falls back to interactive selection.

Task list (tasks list)

Now shows task IDs in text output. Supports --json for structured output (array of {id, name, due_on}).

Task search (tasks search)

• Now shows task IDs in text output
• New --limit/-l flag for result count
• Supports --json for structured output
• Breaking: --assignee no longer defaults to me — omit to search all assignees, pass --assignee me explicitly to filter
• Renamed: --creator-any → --creator for natural flag naming

Task delete (tasks delete)

New command. Takes task ID as argument, confirms task exists, then deletes it.

Projects sections (projects sections)

New command. Lists sections for a named project using paginated API calls.

AddFollowers API

Separate endpoint method since Asana rejects followers in the PUT /tasks/{id} body. Uses POST /tasks/{id}/addFollowers.

Name matching

All name-based flags support case-insensitive exact matching, partial/contains matching, and Asana GID matching.

Claude Code plugin (claude-plugin/)

• Skill: using-asana-cli — full command reference with search flags table, list-vs-search guidance, and verification steps
• Skill: troubleshooting-asana — error diagnosis with common error table
• Agent: asana-task-manager — autonomous agent for end-to-end Asana task management
• Commands: asana-create-task, asana-update-task, asana-delete-task slash commands
• Settings: permission allowlist for asana CLI commands
• Scripts: check-auth.sh utility for verifying CLI authentication

README

• Document Claude Code Plugin: installation, included skills/commands/agent, prerequisites
• Full documentation of all new CLI flags and commands

Test plan

• asana tasks create -n "Test" -a me -p "Project" -d tomorrow creates task without prompts
• asana tasks update <id> --complete marks task complete
• asana tasks view <id> displays task details with permalink URL
• asana tasks view <id> --json outputs structured JSON
• asana tasks list --json outputs JSON array with task IDs
• asana tasks search --query "test" --limit 5 --json outputs limited JSON results
• asana tasks search --query "test" searches all assignees (no default filter)
• asana tasks search --creator me filters by task creator
• asana tasks delete <id> removes task
• asana projects sections "Project Name" lists sections
• All commands fall back to interactive mode when flags/args omitted
• Existing interactive workflows remain unchanged
• Claude Code plugin loads and skill activates on Asana mentions

🤖 Generated with Claude Code

[timwehrle]

Thanks for the pull request. Please fix the failing tasks. As this entire PR was generated by Claude, it will take some time to approve it.

[jtsternberg]

Fixed! The CI failure was a typecheck lint error — create_test.go referenced a getOrPromptDueDate function that didn't exist as a standalone helper. The due-date logic was inlined in runCreate instead.

The fix extracts that inline logic into a proper getOrPromptDueDate(opts) helper function that both runCreate and the tests can use. Build and tests pass locally now.

[jtsternberg]

BTW, thanks for taking a look at the PR.
No pressure on this PR at all — feel free to close it if these changes don't align with your vision for the project. I'm maintaining my fork for my own workflow needs either way, so nothing lost on my end.