2026.07.1

• Bare mdd (no args) now shows a compact ASCII hero banner and quick-start with the most common commands, instead of the full help dump — run mdd --help for the complete reference.
• Short-hand aliases for every command verb are back: -l, -f, -t, -c, -e, -an, -d, -n, -o, -dc, -lint, -id.

v3.4.0

Fixes go install for good: go install github.com/i-am-fran/markdown-do/cmd/mdd@latest has never actually worked — release tags were bare (3.2.1, 2026.07.1), which Go's module tooling doesn't recognize as valid versions at all, so @latest always silently resolved to the ancient, mislabeled v1.0.0 tag instead of the real latest release. Fixing this needed two changes together:

• Tags are now v-prefixed (v3.4.0), which Go requires to recognize a version at all.
• The module path is now github.com/i-am-fran/markdown-do/v3 (previously no suffix) — Go separately requires the import path to carry a matching /vN suffix once the tagged major version reaches 2+, or it rejects the version outright.

go install github.com/i-am-fran/markdown-do/v3/cmd/mdd@latest is the corrected, working install command.

3.2.2

• mdd update now downloads and swaps in the actual release binary for your platform, verifying its checksum first, instead of shelling out to go install. A new release workflow builds and attaches binaries for macOS (Intel + Apple Silicon), Linux (amd64 + arm64), and Windows to every published release.
• mdd no longer writes .mdd-cache / .mdd-undo into the project directory it's operating on — both now live under ~/.config/markdowndo/.
• mdd list --active / --done filter to only open or only completed tasks; mdd add --path DIR targets a TODO.md in another directory.

3.2.1

Fixes `mdd update` (shipped in 3.2.0): it was using `go install .../cmd/mdd@latest`, which only recognizes `v`-prefixed semver tags and was silently installing the ancient `v1.0.0` release instead of the real latest one. `mdd update` now resolves the latest release via the GitHub API and installs that exact tag. README/docs "Go install" instructions updated to match.

3.2.0

• Add `mdd undo` — reverts the last change made through mdd; run it again to redo (toggle behavior).
• Add `mdd update` — installs the latest release via `go install`.
• Fix the Go module path (`i-am-fran/markdowndo` → `i-am-fran/markdown-do`), which never matched the actual repo and silently broke `go install`/`go get`.
• Finish the MarkdownDO → Markdown-do rebrand.

3.1.0

Adds shell tab-completion.

• mdd completion bash / mdd completion zsh print a completion script — install with source <(mdd completion zsh) (or bash) in your shell rc file
• Tab-completes command verbs (mdd ar → mdd archive) and section tags (@Bu → @Bugs), including your custom aliases and any section already in TODO.md

3.0.1

• `mdd tag` now generates IDs with a separator and 3-digit padding from the start (e.g. `ABC-001` instead of `ABC01`), so the format stays visually aligned past 99 items instead of drifting from 2 to 3 digits mid-sequence.
• IDs already tagged in the old `ABC01` format continue to be read and referenced correctly — only newly generated IDs use the new format.

3.0.0

Breaking changes

• TUI removed. MarkdownDO is CLI-only now. A bare mdd invocation shows help instead of launching an interactive menu.
• TUI-only settings removed: theme, fullscreen, showStatusBar, enableAnimations, enableTUI are gone from config.json handling and mdd config list/get/set. Existing config files with those keys still load fine — the keys are just ignored.

Other

• Dropped the bubbletea, bubbles, lipgloss, glamour, and sahilm/fuzzy dependencies along with the TUI code.
• Updated the README and docs site to match.

2.2.0

• `mdd archive` moves every completed task into a `## Archive` section (created automatically, always kept last, ahead of `## Notes`), appending "(from
  )" so the original section isn't lost. Unlike `mdd clear`, it doesn't delete anything and isn't gated by `confirmDestructive`.

v1.0.0

First public release