Lightweight notes
for your repo
Leave a thought, not a document. notd stores notes right in your repo — git-native, zero config, always with your code.
Why notd
Built for developers who think in the terminal.
Git-native
Notes live in .notd/ inside your
repo. Commit them, branch them, ignore them
— your call.
Markdown
Write notes in Markdown. Structure with
headings, lists, and code blocks — saved
as plain .md files.
Tagged
Add tags to notes and edit them anytime. Find exactly what you left for yourself.
Shareable
Push your notes with your commits. Your team inherits your context automatically.
Commands
Four commands. That's it.
notd new
Opens an interactive prompt to write a new
note. Supports Markdown — use
headings, lists, and code blocks. Press
Ctrl+D on a new line to save.
notd list
Lists all notes in the current repo. Shows the id, date created, title, and tags.
notd edit
<id>
Interactively update the tags on a note.
Shows the current tags and prompts for new
ones as a comma-separated list. Press
Enter to keep existing tags.
notd delete
<id>
Permanently removes a note. The
.md file is deleted from
.notd/.