Task AI

Welcome to Task AI - a command-line todo list with some extra ai features.

Here's what you can do:

task show all --> show all of your lists and item names, with their respective IDs prepended
task show {id or substring} --> find the list or item matching your identifier and show it using its respective type's show command
task show list {id or substring} --> show the list and all of its item names
task show item {id} --> show the associated item and all of its specified information
task show items {id1},{id2},...,{idx} --> show the associated items and all of their specified information
task create item {list id or substring} {name} {**kwargs} --> Create a new item for the associated list. Can specify kwargs as --optional cli arguments.
task create list {name} --> create a new list by that name
task delete {id} --> deletes the list or item associated with that id
task delete item {id} --> deletes the item associated with that id
task delete list {id} --> deletes the list associated with that id
task delete completed --> deletes all items that have been completed
task remove ... --> aliases directly to 'task delete ...
task update {item id} {**kwargs} --> updates the associated attributes on the item
task comment {item id} {content} --> adds a comment to that items comment thread
task ai {prompt} --> Feeds a prompt directly to an LLM, which constructs and executes a series of task commands according to its interpretation of the prompt
task ai headstart {item id} --> Feeds the item context to an LLM, which responds with a concise description of the next step to perform. The response is added as a comment in the items comment thread
task nuke --> deletes all of your task data, letting you have a fresh start
task add ... -> aliases directly to task create item ...
task complete {item id} --> sets the associated item's .completed attribute to true

Run task show examples to print a comprehensive set of examples, and grep for the ones that you're interested in!

Run task by itself to run in interactive mode, which improves performance.

Installation

pip install taskai-cli

Configuration

For first time usage, run our setup command:

task setup

This will walk you through the necessary steps to get all features set up.

In order to edit or view your configurations, you can use the task config command family

task config show  # --> lists your current configuration options
task config set {key} {value}  # --> Sets a given value
task config get {key}  # retrieves a given value

Release files for taskai-cli 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for taskai-cli 1.0.1
File	Size	Uploaded
taskai_cli-1.0.1.tar.gz	17.2 kB	Jun 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for taskai-cli 1.0.1
File	Interpreter	ABI	Platform	Reset
taskai_cli-1.0.1-py3-none-any.whl 14.7 kB Jun 23, 2026	Python 3	none	any	Details

Total release size: 31.8 kB

Release files / taskai_cli-1.0.1.tar.gz

Download URL	taskai_cli-1.0.1.tar.gz
Size	17.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`8d6f5a9a556844692073b0098b62afa37b103ce5b7d273337371499b9f994447`
BLAKE2b-256 checksum How to use checksums	`e2ec4d3b6c49ed77073cc919b4c958efce9847577b9d98477361599c2b829fcb`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/alexander-paskal/taskai
Publishing commit: github.com/alexander-paskal/taskai/tree/db0cbb0e0545fcec48226a3641d5f11620f24bb7

Workflow

Publishing configuration: github.com/alexander-paskal/taskai/blob/db0cbb0e0545fcec48226a3641d5f11620f24bb7/.github/workflows/publish-to-pypi.yml
Publishing logs: github.com/alexander-paskal/taskai/actions/runs/27992425736/attempts/1

Artifact

Subject: taskai_cli-1.0.1.tar.gz
SHA-256 checksum: 8d6f5a9a556844692073b0098b62afa37b103ce5b7d273337371499b9f994447 Verifying attestations

Release files / taskai_cli-1.0.1-py3-none-any.whl

Download URL	taskai_cli-1.0.1-py3-none-any.whl
Size	14.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0ccbfe8ab6dfdb34987ab19da6111da45d015cefbc0d9e30af90964ee7f85d9c`
BLAKE2b-256 checksum How to use checksums	`7b7f5baac12648060f39176cf8dee6e6df9148e9529a604e70d0be64f477bea8`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/alexander-paskal/taskai
Publishing commit: github.com/alexander-paskal/taskai/tree/db0cbb0e0545fcec48226a3641d5f11620f24bb7

Workflow

Publishing configuration: github.com/alexander-paskal/taskai/blob/db0cbb0e0545fcec48226a3641d5f11620f24bb7/.github/workflows/publish-to-pypi.yml
Publishing logs: github.com/alexander-paskal/taskai/actions/runs/27992425736/attempts/1

Artifact

Subject: taskai_cli-1.0.1-py3-none-any.whl
SHA-256 checksum: 0ccbfe8ab6dfdb34987ab19da6111da45d015cefbc0d9e30af90964ee7f85d9c Verifying attestations