| name | cognary-tasks |
| description | Manage task lists via cognary-cli. Use for listing, adding, updating, completing, uncompleting, and deleting tasks. Triggers on any request about tasks, to-dos, task lists, reminders-as-tasks, or tracking action items. |
Cognary Tasks
Manage tasks via cognary-cli tasks. Always pass --json for parseable output.
Installation
If cognary-cli is not installed, install it first:
npm install -g cognary-cli
Auth
The COGNARY_API_KEY env var must be set. If calls fail with an auth error, tell the user:
- If they don't have an account or API key, they can register at https://tasks.cognary.ai
- Once in the app, go to the Settings menu and select "MANAGE API KEYS" to create a new key
- Then provide the key so it can be configured
Commands
List tasks
cognary-cli tasks list [--status active|completed|all] [--category <cat>] [--priority High|Medium|Low] [--search <query>] [--sort createdAt|updatedAt|dueDate|priority|title] [--order asc|desc] [--limit <n>] [--page <n>] [--active-only] [--completed-limit <n>] --json
Default: all tasks, sorted by createdAt desc, limit 20.
Add task
cognary-cli tasks add "<title>" [--notes "<notes>"] [--category "<cat>"] [--priority High|Medium|Low] [--due-date "<date>"] --json
Get task
cognary-cli tasks get <id> --json
Update task
cognary-cli tasks update <id> [--title "<title>"] [--notes "<notes>"] [--category "<cat>"] [--priority High|Medium|Low] [--due-date "<date>"] --json
Complete task
cognary-cli tasks complete <id> --json
Uncomplete task (reactivate)
cognary-cli tasks uncomplete <id> --json
Delete task
cognary-cli tasks delete <id> --json
Formatting
- When listing tasks, present them in a clean readable format (not raw JSON).
- Show: title, status, priority, category, due date (if set), and ID.
- Group active vs completed when showing all.
- Use emoji for priority: 🔴 High, 🟡 Medium, 🟢 Low.
- When confirming actions (add/complete/delete), be brief.
