dewy#
A fast, minimal TUI for Todoist built with React.js + Ink + Typescript.
Features#
- Filter views — browse tasks by Todoist filter queries like
today,overdue, or custom filters - Project views — jump to any project by name
- Quick add — add tasks using Todoist's quick add syntax (dates, labels, projects all work)
- Smart hints — command suggestions appear as you type
- XDG config — simple JSON config at
~/.config/dewy/config.json
Install#
npm install --global dewy
Quick Start#
-
Grab your API token from Todoist settings
-
Create your config file:
mkdir -p ~/.config/dewy
cat > ~/.config/dewy/config.json << 'EOF'
{
"apiToken": "your-token-here"
}
EOF
- Run it:
dewy
Configuration#
| Key | Type | Required | Description |
|---|---|---|---|
apiToken |
string |
yes | Your Todoist API token |
homeFilter |
string |
no | Todoist filter for the home view (default: today) |
Commands#
| Command | Description |
|---|---|
add <task> |
Add a task via quick add |
done <number> |
Complete a task by its number |
project <name> |
View tasks in a project |
filter <query> |
View tasks matching a Todoist filter |
today |
View today's tasks |
home |
View the home filter |
refresh |
Reload tasks |
quit |
Exit |
License#
GPL-3.0-or-later