Cognary CLI

Command-line interface for Cognary Tasks.

Installation

cd cognary-cli
npm install
npm link  # Optional: makes 'cognary-cli' available globally

Authentication

The CLI requires an API key to authenticate with the Cognary Tasks API. You can provide it in two ways:

1. Environment variable (recommended):

   export COGNARY_API_KEY=nts_your_api_key_here

2. Command line option:

   cognary-cli --api-key nts_your_api_key_here tasks list

Configuration

You can also configure the API URL:

# Environment variable
export COGNARY_API_URL=https://your-api-url.com

# Or command line option
cognary-cli --api-url https://your-api-url.com tasks list

Commands

List Tasks

cognary-cli tasks list

Options:

• -l, --limit <number> - Number of tasks to return (default: 20)
• -p, --page <number> - Page number (default: 1)
• -s, --status <status> - Filter by status: active, completed, all (default: all)
• -c, --category <category> - Filter by category
• --priority <priority> - Filter by priority: High, Medium, Low
• --search <query> - Search tasks
• --sort <field> - Sort by: createdAt, updatedAt, dueDate, priority, title
• --order <order> - Sort order: asc, desc (default: desc)
• --json - Output as JSON

Examples:

# List all tasks
cognary-cli tasks list

# List only active tasks
cognary-cli tasks list --status active

# Search for tasks containing "meeting"
cognary-cli tasks list --search meeting

# List high priority tasks sorted by due date
cognary-cli tasks list --priority High --sort dueDate --order asc

# Output as JSON
cognary-cli tasks list --json

Get a Single Task

cognary-cli tasks get <task-id>

Options:

• --json - Output as JSON

Example:

cognary-cli tasks get abc123-def456-ghi789