termnotes (tn)

Zero‑config daily notes + tasks in your terminal. Each day is one Markdown file with two sections: Tasks and Notes

Installation

Requires Bun.

npm install -g termnotes-cli
pnpm install -g termnotes-cli
bun add -g termnotes-cli

Quick Start

Both tn and termnotes work. The first run creates today’s file if missing.

# Add a task (shorthand for `tn task`)
tn t Ship the new feature

# Add a note (shorthand for `tn note`)
tn n ChatGPT said I was absolutely right

# Mark task as complete (starting at 1)
tn x 1

# View today's notes
tn

Output:

## Tasks

[x] Ship the new feature

## Notes

- ChatGPT said I was absolutely right

Commands

Command	Shorthand	Description
tn	—	View today’s note
tn task [text]	tn t [text]	Append a task
tn note [text]	tn n [text]	Append a note bullet
tn x <number>	—	Toggle task status at 1‑based index
tn --help	—	Show help / usage

Features

• Focus on Today: Always opens today’s Daily Note. A new file is created on first use each day.
  • Planned feature for importing previous day uncompleted tasks and viewing historical notes
• Viewer auto-detect: Prefers glow, then bat, else falls back to cat.
• Location: Default location: ~/.termnotes/notes/YYYY-MM-DD.md (configurable in a future release).

Uninstall

Use the uninstall command from the package manager used to install the CLI.

Manually delete ~/.termnotes.

Development

bun install
bun dev

---

Planned Enhancements

• Configurable notes directory
• Task carry‑over from previous day
• Archiving and search