tipin
tipin is a small terminal tool, one Go program with no dependencies, that attaches correction slips to any text file without ever editing it: tipin notes.md 14 "for Friday read Thursday" writes the slip into notes.md.tipin beside the file, tipin show notes.md prints the file exactly as it is with a numbered marker in the gutter and the corrections at the foot, tipin print notes.md makes a 72 by 30 cut-out slip to tuck into a paper copy, tipin check . finds sidecars whose file was moved (ORPHAN), copies that left their slips behind (BARE COPY) and slips that no longer fit the text, and tipin drop notes.md 2 withdraws a slip while keeping it on record. Build it with go build -o tipin . (Go 1.22 or later), run go test ./... for the anchoring table and the acceptance flows, sh accept.sh for the shell side of the checks, and uv run --with playwright python shots.py (with tmux and Chromium for Playwright) for the screenshots. The real input is any text file you were given and may not edit: a vendored README, a contract, a colleague's notes; the tests use src/fmt/doc.go and src/fmt/print.go from the installed Go. A sidecar quotes the faulty line in the clear, so keep it as private as the file. README.txt is the tool's own short notice, at most eight lines.
Colophon. Set in whatever monospace your terminal already has, at 72 columns. No colour was used. Corrections, where they exist, are at the foot. The text above is as printed.
Files
- README.md
- README.txt
- README.txt.tipin
- accept.sh
- anchor.go
- anchor_test.go
- check.go
- go.mod
- main.go
- out/accept.txt
- out/check-project.txt
- out/readme-slip-print.txt
- out/readme-slip.txt
- out/screen-add-desktop.txt
- out/screen-add-phone.txt
- out/screen-check-desktop.txt
- out/screen-check-phone.txt
- out/screen-print-desktop.txt
- out/screen-print-phone.txt
- out/screen-show-desktop.txt
- out/screen-show-phone.txt
- out/screen-show-top-desktop.txt
- out/screen-show-top-phone.txt
- out/screen-usage-desktop.txt
- out/screen-usage-phone.txt
- out/timing-first.txt
- out/timing-second.txt
- out/transcript.txt
- print.go
- shots.py
- sidecar.go
- tipin_test.go