| save | |
| tuck note "text" | save a note |
| tuck cmd "text" | save a runnable command |
| tuck todo "text" | save a todo item |
| tuck warn "text" | save a warning |
| tuck snap | snapshot current branch, ports, runtime versions |
| view | |
| tuck ls | list all entries for current project |
| tuck grep <term> | search across all projects |
| tuck summary | one-line count, for shell prompt |
| act | |
| tuck run <id> | execute a saved command |
| tuck done <id> | toggle todo done / undone |
| tuck rm <id> | remove an entry |
| tuck clear | remove all entries for current project |
| team | |
| tuck team | show team mode status |
| tuck team on | enable team mode, share notes via git |
| tuck team off | disable team mode |
| tuck team sync | merge teammates notes after git pull |
Captures a snapshot of the current development environment and saves it as an entry.
Records: git branch, listening ports, node / go / python versions.
$ tuck snap snap saved #4
The .tuck file lives in the project directory.
Committing it shares your notes with anyone who pulls the repo.
$ tuck team on team mode on commit .tuck to share notes with teammates. $ git add .tuck && git commit -m "add project notes" # teammate pulls and syncs $ tuck team sync +3 entries synced from teammates
tuck team sync merges by content hash. Duplicate entries are skipped automatically.
Add to ~/.zshrc or ~/.bashrc to see a summary on every directory change:
function cd() { builtin cd "$@" && tuck summary; }
Each project stores a .tuck file in its root directory.
A global index at ~/.tuck-index enables cross-project search.
No daemon, no server, no cloud. Just files.