← Alex Tryshchenko / Projects View on GitHub

Side work / Day Planner

A to-do list that remembers yesterday.

Day Planner is a terminal to-do list sorted by day. Whatever you didn’t finish waits under Yesterday instead of quietly scrolling away, and every task has room for notes right next to it.

Free. A single Go binary for macOS and Linux; your tasks live in one SQLite file.

  • 3sections: Today, Yesterday, Old
  • 1SQLite file in your home folder holds it all
  • 0accounts, servers or sync services
  • 1 sto sync two open terminals

01 / The idea

Most to-do lists forget what you didn’t do.

A flat list grows until the old items stop meaning anything. A daily note starts empty every morning and yesterday’s leftovers are gone. Day Planner keeps one list but files every task under the day it was added, so you can see at a glance what’s new, what slipped and what has been sitting there for two weeks.

The usual list

  • Old and new tasks look exactly the same
  • Unfinished work disappears with the day’s note
  • Done items pile up or vanish with no record
  • Context lives in a different app
  • Another account, another browser tab

Day Planner

  • Tasks are grouped by day and coloured as they age
  • Unfinished tasks wait in Yesterday, then Old, with their date
  • Crossed-out tasks stay until midnight, then move to Completed
  • Every task has a notes pane that saves as you type
  • Opens in your terminal in an instant, no login

02 / How a day works

Tasks move on their own. You decide what comes back.

There’s nothing to schedule or tag. The date you added a task is enough.

  1. 01

    Add

    Press n and type. New tasks always land in Today. Hit tab to jot details: links, steps, who to ask. Notes save themselves a moment after you stop typing.

    • n new
    • e edit title
    • tab notes
  2. 02

    Cross out

    Press space to cross a task out. It stays in the list for the rest of the day, struck through, so you can see what you got done. The progress bar in the header keeps count.

    • space toggle
    • Progress per section
  3. 03

    Roll over

    At midnight, crossed-out tasks move to the Completed page and anything left open drops into Yesterday. On Mondays, Yesterday covers Friday to Sunday, so the weekend doesn’t push your Friday work out of sight.

    • Happens while it’s open
    • Mon: Fri – Sun
  4. 04

    Bring back or let go

    Older open tasks collect under Old with the day they were added. Press t to pull one back into Today, x to delete it, or z to fold the section away for now.

    • t to today
    • x delete
    • z fold

03 / Features

Small, fast, and out of your way.

Everything is one keypress away, and the mouse works too.

Notes beside every task

A full multi-line editor in the details pane, with word jumps, paste and scrolling. Tasks with notes get a small ≡ mark in the list.

A record of what you did

Press c for the Completed page: every crossed-out task grouped by day, with when it was added and when you finished it. space restores one to Today.

Keyboard first, mouse welcome

Arrows or j/k, g/G to jump. Click to select, double-click for details, click the circle to cross out, scroll with the wheel. ? shows every key.

Two terminals, one list

Open it in as many terminals as you like. Each one notices changes made elsewhere within a second and redraws, without losing what you’re typing.

Fits any window

Wide terminals show the list and details side by side. In a narrow split, details take over the screen when you open them, and p hides the pane altogether.

Your data, one file

Everything is in ~/.day-planner.db, a plain SQLite database you can back up, sync or query. Set DAY_PLANNER_DB to keep it somewhere else.

04 / Screens

What it looks like.

A Tokyo Night palette, sections that warm up as tasks age, and hints for the keys along the bottom.

05 / Under the hood

No framework, no cgo, no waiting.

Day Planner talks to the terminal directly and keeps its data in SQLite, so it starts instantly and builds into a single static binary.

  • Its own renderer. The UI is drawn into a cell grid and only rows that changed are sent to the terminal, wrapped in synchronized-output sequences so nothing flickers. Raw mode, true colour, SGR mouse and bracketed paste are handled by hand.
  • Pure-Go SQLite. Storage uses modernc.org/sqlite in WAL mode: no C toolchain, no shared libraries, one file on disk.
  • Live updates for free. Once a second it reads SQLite’s data_version, which changes only when another process commits. That’s how separate terminals stay in step without a server.
  • Days done right. Sections are computed from your local midnight, Monday folds in the weekend, and the list re-sorts itself if you leave it open overnight.
  • Tested by frame. Tests drive the app with key and mouse events and check the rendered screen at wide and narrow sizes, alongside the input parser and the text editor.

06 / Get started

Up and running in a minute.

On an Apple Silicon Mac, the repository already includes a built day-planner binary. Everywhere else, build it with Go.

# needs Go 1.26 or newer
git clone https://github.com/tryshchenko/tui-day-planner.git
cd tui-day-planner
go build -o day-planner .
./day-planner

# optional: keep the database elsewhere
DAY_PLANNER_DB=~/Documents/tasks.db ./day-planner

Start each day knowing what’s left from the last one.

One list, sorted by day, a keypress away in your terminal.

Day Planner on GitHub