mach

A terminal-based weekly planner inspired by Tweek. Plan your week with vim-style navigation, organize someday items in a backlog, and stay focused without leaving your terminal.

Features

• Weekly view — 7-day columns showing your week at a glance
• Backlog view — 4-column organizer for "someday" items
• Workspaces & Projects — Organize todos with a two-level hierarchy
• Vim navigation — h/j/k/l to move, Enter to select and drag
• Local-first — SQLite storage, no cloud, no account needed
• Adaptive colors — Uses terminal theme colors for universal compatibility

Installation

Homebrew

brew install rvcas/tap/mach

Shell (Linux/macOS)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rvcas/mach/releases/latest/download/machich-installer.sh | sh

PowerShell (Windows)

powershell -ExecutionPolicy Bypass -c "irm https://github.com/rvcas/mach/releases/latest/download/machich-installer.ps1 | iex"

npm/pnpm/bun

npm install -g @rvcas/mach

Cargo

cargo install machich

From source

git clone https://github.com/rvcas/mach
cd mach
cargo install --path crates/mach

Quick Start

Launch the TUI:

mach

Add a todo from the command line:

mach add Buy groceries
mach add --some-day Learn piano

List todos:

mach list              # today's tasks
mach list --some-day   # backlog items
mach list --done       # completed items

Keyboard Shortcuts

Weekly View

Key	Action
h/l	Move left/right between days
j/k	Move down/up within a column
[/]	Previous/next week
Enter	Select item (then h/l moves it, j/k reorders)
Space	Open todo details (edit title, date, notes)
a	Add new todo to focused column
x	Toggle completion
dd	Delete todo
s	Send to backlog
t	Move to today
T	Move to tomorrow
b	Open backlog view
gs	Settings (week start day)
?	Toggle help
q/Esc	Quit

Backlog View

Key	Action
h/j/k/l	Navigate across 4 columns
Enter	Select item (then h/l moves between columns)
Space	Open todo details
a	Add new todo
x	Toggle completion
dd	Delete
t	Move to today
T	Move to tomorrow
?	Toggle help
b/q/Esc	Return to weekly view

Todo Details

Key	Action
j/k	Navigate between fields
Enter	Edit / confirm
Ctrl+j	New line (in notes)
x	Toggle completion
Esc	Close (or cancel edit)

Add Todo Popup

Key	Action
Enter	Submit
Esc	Cancel
Backspace	Delete character

How It Works

• Todos scheduled for a day appear in that day's column
• Overdue incomplete todos automatically roll forward to today
• Completed todos sink to the bottom of their column
• New todos appear at the top of the column

Sponsor

If you find mach useful, consider sponsoring its development.

License

Apache-2.0