Командная строка

todowl это небольшая утилита командной строки, которая работает через тот же API, что и AI-клиенты. Всё, что можно сделать в приложении, можно сделать из терминала.

Установка

Утилита лежит в исходниках ToDowl, поэтому собирается один раз:

git clone https://github.com/supafast-tech/todowl.git
cd todowl && pnpm install --filter @todowl/cli
pnpm --filter @todowl/cli build
cd cli && npm link

Нужен Node 22 или новее.

Вход

todowl auth login

Команда откроет браузер, выполнит вход и сохранит свежий API-ключ в ~/.config/todowl/config.json с правами только для вас. Если ключ уже есть, можно указать его напрямую:

todowl auth token todowl_ВАШ_КЛЮЧ

todowl auth status покажет, под кем вы вошли, todowl auth logout забудет ключ на этой машине.

Повседневные команды

todowl task list --status open
todowl task create --title "Позвонить в банк" --date 2026-09-01 --priority high
todowl task complete a1b2c3d4
todowl task move a1b2c3d4 --project 7f3e1c02
todowl project list
todowl event list --from 2026-09-01 --to 2026-09-07
todowl note list --query счёт
todowl habit checkin 5c9a11de
todowl trash list

Идентификаторы длинные, поэтому в списках печатаются первые восемь символов, и все команды принимают эту короткую форму. Если короткий идентификатор подходит сразу нескольким записям, утилита скажет об этом, а не будет угадывать.

Добавьте --json к любой команде, чтобы получить машиночитаемый вывод: именно он делает утилиту пригодной для скриптов. Полный список команд печатает todowl --help.

Что покрыто

Задачи, проекты, списки, события календаря, заметки, привычки и корзина, по тем же правилам, что и в приложении: удаление отправляет в корзину, архивирование убирает из списков без удаления, и всё происходит в вашем аккаунте.

Все команды, все опции и инструмент, который стоит за каждой из них, есть в справочнике API.