# todoist
> Todoist CLI client for managing tasks from the terminal

## Summary
A Go-based CLI client for Todoist that provides full task management with filtering, labels, projects, and fuzzy-selection integration.

## Capabilities
- List, add, modify, close, and delete tasks
- Manage projects and labels
- Filter tasks with custom filter syntax
- Quick-add tasks with natural language processing
- Integration with peco/fzf for interactive selection
- CSV output for scripting and data export
- Shell completion for bash and zsh
- View completed tasks and karma stats

## When to Use
- You use Todoist and want to manage tasks without leaving the terminal
- You want to script task creation and management
- You prefer keyboard-driven task management over a GUI

## When NOT to Use
- You don't have a Todoist account
- You want an offline-only todo manager
- You need a full project management suite beyond task tracking

## Usage Patterns
### List all tasks
```
todoist list
```
Shows all active tasks from your Todoist account

### Quick-add a task
```
todoist quick 'Buy groceries tomorrow #Shopping'
```
Adds a task using Todoist's natural language parsing

### Filter tasks by project
```
todoist list --filter '#Work'
```
Shows only tasks in the Work project

### Close a task
```
todoist close TASK_ID
```
Marks a task as complete

## Installation
- **homebrew**: `brew install sachaos/todoist/todoist`

---
Source: https://littlescripts.sh/tools/todoist