Metadata-Version: 2.4
Name: tuidoist
Version: 0.1.0
Summary: Terminal-first toolkit for Todoist — scriptable CLI and interactive TUI
Author: Tyler Lotz
License-Expression: MIT
Project-URL: Homepage, https://github.com/tjlotz/tuidoist
Project-URL: Repository, https://github.com/tjlotz/tuidoist
Project-URL: Issues, https://github.com/tjlotz/tuidoist/issues
Keywords: todoist,tui,cli,terminal,productivity,tasks
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Scheduling
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: todoist-api-python>=2.1.0
Requires-Dist: pytermgui>=7.7.0
Requires-Dist: typer>=0.12.0
Dynamic: license-file

# Tuidoist

A terminal power tool for Todoist. Not a TUI remake — a productivity multiplier.

Tuidoist extends Todoist with workflows its own UI can't do: bulk-add 20 tasks in one shot,
paste a recipe and let AI extract the steps, filter by task age or staleness, move entire
sets of tasks with a single command, and pipe tasks into scripts.

## Features

- **Smart parsing** — paste unstructured text (lists, recipes, messages) and let AI extract tasks with inferred properties
- **Bulk operations** — add, move, or reschedule many tasks at once with shared properties
- **Custom filters** — filter by task age, staleness, overdue duration, missing due dates, orphaned inbox items
- **Task templates** — save reusable task definitions with subtasks and default properties
- **Time tracking** — log time on tasks and visualize productivity with a GitHub-style heatmap
- **Pipe support** — compose with other CLI tools: `echo "Buy milk" | tuidoist add`, `tuidoist list --json | jq`
- **Vim keybindings** — j/k navigation, keyboard-driven everything

## Install

Requires Python 3.12+.

With [uv](https://docs.astral.sh/uv/) (recommended):
```
uv tool install tuidoist
```

Or with pipx:
```
pipx install tuidoist
```

Then launch:
```
tuidoist
```

On first run, you'll be prompted for your Todoist API token.
Find it at: **Todoist Settings → Integrations → Developer**

## Keybindings

| Key   | Action           |
|-------|------------------|
| j / k | Navigate down/up |
| Enter | Select           |
| Esc   | Back / Quit      |
| h / l | Cycle tabs       |
| q     | Quit             |

## Development

Clone and install in editable mode:
```
git clone https://github.com/tjlotz/tuidoist.git
cd tuidoist
uv venv
uv pip install -e .
uv run tuidoist
```

See [RELEASING.md](RELEASING.md) for the release process.
