Open source on GitHub

Terminal to-do list for Markdown files

Add, filter and tick off tasks from your shell. plaintask edits the same .md files the Plaintask app and the Obsidian plugin read, one line per task.

Every command edits a file you can read

  1. One task is one line

    plaintask add writes a checkbox line, with its date, deadline and tags after it, into the right .md file.

  2. Projects are files, areas are folders

    Home, Work and Health are folders in ~/Tasks. --project and --area name a file or a folder.

  3. The CLI, the app and agents share them

    The command line, the Plaintask app and AI agents over MCP open the same folder, so a task added here shows up there.

Markdown task files stacked on three folders, Home, Work and Health, joined to the app, the command line and an AI agent

Your task files in one terminal

Pick a file on the left, or let plaintask show print a project with its deadline and headings. done ticks a line; Git sees one changed line.

Three plaintask commands run a day

  1. Capture tasks with add

    New tasks go to Inbox.md, or straight into a project with --project and a date.

  2. Plan tasks with list and move

    Filter by due date, tag or area, then move a task to another day with --when.

  3. Finish tasks with done

    Tick off by number or name. A repeating task writes its next date; the logbook keeps the rest.

plaintask is built for shell scripts. Plain text in, plain text out.

Prints JSON for scripts

Every list command takes --json, so jq, cron jobs and status bars can read your tasks.

scriptszsh
~/Tasks $ plaintask list --tag call --json | jq -r '.[].title'
Book a check-up
Book the electrician
Call back two candidates

~/Tasks $ plaintask list --json | jq length
31

Shows each change in git diff

A ticked task is one changed character, so your task folder keeps a readable history in Git.

gitzsh
~/Tasks $ git diff Home/Garden.md
@@ -2,3 +2,3 @@ # Garden
-- [ ] Rake the leaves when:saturday
+- [x] Rake the leaves when:saturday
 - [ ] Plant tulip bulbs due:2026-11-30
 - [ ] Clean the gutters repeat:3-months

Completes commands in zsh, bash and fish

Tab completes flags, project names and tags from the files in your folder.

zshzsh
~/Tasks $ plaintask list --
--due       tasks due by a date
--when      tasks scheduled for a date
--tag       tasks with a tag
--project   tasks in one project file
--area      tasks in one area folder
--json      print JSON for scripts

Opens task files in your editor

plaintask edit kitchen opens the project file in $EDITOR at the first open task.

Kitchen renovation.mdzsh
---
area: Home
deadline: 2026-12-12
---
# Kitchen renovation
## Order
- [x] Measure the floor
- [ ] Order floor tiles due:2026-11-28
~
~
-- INSERT --

Your task list is plain text

So grep finds a task, sed renames a tag across every project, and a cron job can mail you what is due.

~/Taskszsh
~/Tasks $ grep -rn "#call" .
./Home/Kitchen renovation.md:12:- [ ] Book the electrician #call
./Health/Dentist.md:2:- [ ] Book a check-up #call
./Work/Hiring.md:3:- [ ] Call back two candidates #call

~/Tasks $ sed -i '' 's/#call/#phone/g' **/*.md
~/Tasks $ plaintask list --tag phone
 4  [ ] Book a check-up         Dentist
 8  [ ] Book the electrician    Kitchen renovation
 11 [ ] Call back two candidates Hiring

Install plaintask

Install with Homebrew or the npm package manager, point it at a folder, and add shell completion. An empty folder gets an Inbox.md and two areas to start.

  • brew install plaintask
  • npm install -g plaintask
  • plaintask init ~/Tasks
~zsh
~ $ brew install plaintask
✓ plaintask installed

~ $ plaintask init ~/Tasks
✓ Created ~/Tasks with Inbox.md, Home/ and Work/

~ $ plaintask completion zsh >> ~/.zshrc
~ $ plaintask add "Try plaintask" --when today
+ Try plaintask   Inbox.md:1

Questions

About the plaintask CLI, its files and the other Plaintask editions.

Is plaintask free?

Yes. The CLI is open source, with the Plaintask app and the MCP server, in one public repository.

Does plaintask need the Plaintask app?

No. plaintask works on its own; the app, the Obsidian plugin and agents read the same files when you want them.

Can I keep the tasks folder in Git?

Yes. Each change is a changed line in Git™, and plaintask never rewrites lines it did not touch.

How do I sync task files to my phone?

Any folder sync works: iCloud Drive, Dropbox, Syncthing or Git. Plaintask Pro adds sync built into the paid app.

Which shells get plaintask completion?

zsh, bash and fish, from plaintask completion.