nothing gets forgotten
v0.2.0 Go single binary zero dependencies macOS · Linux

What is it

Every project has things that never make it into the README. Quirks, workarounds, useful commands, warnings for teammates. They end up in Slack, a text file, or forgotten entirely.

tuck stores them in the project directory, indexed by type, searchable across projects.

note

Things worth remembering

cmd

Commands, runnable by ID

todo

Tasks with done toggle

warn

Warnings, shown first

snap

Env snapshot: branch, ports, runtimes

Quick look

$ tuck warn "dont touch auth.js, sarah is refactoring"
warn saved  #1

$ tuck cmd "docker run -p 5432:5432 postgres:15"
cmd saved  #2

$ tuck snap
snap saved  #3

$ tuck ls
backend  ·  /home/user/projects/backend

warns  1
    1  dont touch auth.js, sarah is refactoring  ·  5m ago

cmds  1
    2  docker run -p 5432:5432 postgres:15        ·  4m ago

snaps  1
    3  main  ·  3000 5432  ·  node 20.11  go 1.21  ·  just now

$ tuck grep postgres
backend  ·  /home/user/projects/backend
    2  docker run -p 5432:5432 postgres:15  ·  4m ago

api  ·  /home/user/projects/api
    4  postgres runs on 5433, not default  ·  2d ago

Install

macOS (Apple Silicon)
curl -Lo tuck https://github.com/Malaydewangan09/tuck/releases/latest/download/tuck-darwin-arm64 chmod +x tuck && sudo mv tuck /usr/local/bin/
macOS (Intel)
curl -Lo tuck https://github.com/Malaydewangan09/tuck/releases/latest/download/tuck-darwin-x86_64 chmod +x tuck && sudo mv tuck /usr/local/bin/
Linux (amd64)
curl -Lo tuck https://github.com/Malaydewangan09/tuck/releases/latest/download/tuck-linux-x86_64 chmod +x tuck && sudo mv tuck /usr/local/bin/
build from source
git clone https://github.com/Malaydewangan09/tuck cd tuck && go build -o tuck ./cmd/tuck/ && sudo mv tuck /usr/local/bin/