machich

Crates.io	machich
lib.rs	machich
version	0.3.0
created_at	2025-11-24 05:02:24.678095+00
updated_at	2025-12-20 05:05:16.264317+00
description	A CLI tool for managing todos with a weekly calendar
homepage	https://machich.co
repository	https://github.com/rvcas/mach
max_upload_size
id	1947396
size	219,647

Lucas (rvcas)

documentation

README

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

Commit count: 0