otty / apps

All apps/todo.txt-cli

todo.txt-cli

todotxt-cli

A simple and extensible shell script for managing your todo.txt file.

Runs as todo.sh|macOS, Linux|todotxt.org

Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 10 fields

Run one todo.sh action (add, list, done, pri ...) with its arguments and the common global options. Hide/show toggles (-@, -+, -P), verbosity levels and add-on actions are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui todotxt-cli

Run a todo.sh actionExample values, fixed in this page — nothing here reaches a terminal

Basic

Action

addstring

Arguments*

string

Prepend date when adding

-t

Advanced

Verbose

-v

TasksEach one presets the form for one job

Add a task

actionargsdate_on_addverbose

List tasks

actionargsplain

Mark tasks done

actionargsno_archiveverbose

ParametersOnly these flags are editable in the form

Action

Action name or alias. Add-on actions installed in the actions directory also work.
string · positional 0

addlistlistalldonepridepriappendreplacedelarchivelistprojlistcon

Arguments

Task numbers, text or search terms, as the action expects. Quote task text.
string · positional 1 · repeatable

Config file

path

-d

Force without confirmation

boolean

-f

Plain mode (no colors)

boolean

-p

Color mode

boolean

-c

Do not auto-archive on completion

boolean

-a

Do not preserve line numbers

Blank lines are removed when a task is deleted.
boolean

-n

Prepend date when adding

boolean

-t

Verbose

boolean

-v

SourcesEvery flag above is checked against these

help

help2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed todo.sh against its version. A form that does not match your version is not offered.