Cognary Tasks is an AI-first task manager that turns your spoken thoughts into organized, actionable tasks instantly. Just speak naturally, and Cognary uses AI to prioritize, structure, and manage your to-dos for you. Less effort, more focus — productivity built for the AI era.

# Cognary Tasks

Manage tasks via `cognary-cli tasks`. Always pass `--json` for parseable output.

## Installation

If `cognary-cli` is not installed, install it first:

```bash 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

```bash 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

```bash cognary-cli tasks add "<title>" [--notes "<notes>"] [--category "<cat>"] [--priority High|Medium|Low] [--due-date "<date>"] --json ```

### Get task

```bash cognary-cli tasks get <id> --json ```

### Update task

```bash cognary-cli tasks update <id> [--title "<title>"] [--notes "<notes>"] [--category "<cat>"] [--priority High|Medium|Low] [--due-date "<date>"] --json ```

### Complete task

```bash cognary-cli tasks complete <id> --json ```

### Uncomplete task (reactivate)

```bash cognary-cli tasks uncomplete <id> --json ```

### Delete task

```bash 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.