Usage

All commands follow the pattern nt <command> [arguments].
Running nt or nt help with no arguments prints a summary.

Command Reference

Create a new note. Opens the note in $EDITOR (defaults to nano) after creating it with a timestamp header. Commits automatically on save.

nt new meeting
nt new projects/roadmap      # subdirectory — created automatically

Open an existing note in $EDITOR. Commits automatically on save.

nt edit meeting

Render a note to the terminal with colour-highlighted Markdown — headings, bold, italic, checkboxes, links, and tables.

Aliases: cat, view

nt show meeting
nt cat meeting

List all notes in ~/.config/nt, including those in subdirectories.

Alias: ls

nt list
nt ls

Example output:

Notes in /home/you/.config/nt

  • ideas
  • meeting
  • projects/roadmap

Delete a note after a confirmation prompt. Commits the deletion.

Aliases: rm, remove

nt delete meeting

Case-insensitive full-text search across all notes. Shows the note name and up to three matching lines per note.

Aliases: grep, find

nt search "Alice"
nt search TODO

Display the git commit history of the notes repository in a compact graph format.

nt log

Pass any git command directly to the notes repository. Useful for setting up remotes, pushing, pulling, diffing, and more.

nt git remote add origin git@github.com:you/notes.git
nt git push -u origin main
nt git diff HEAD~1

Code	Meaning
`0`	Success
`1`	Error (message printed to stderr)