Honestly, you're the first person who hasn't recoiled in horror when I explained it. The code I have is very janky. It works about 90% the time and the other 90% of the time I revert to using grep from the command line. I'll document the doc standards I'm using somewhere and then try to fix the code.
The other thing I'm working on is figuring out git plumbing so I can force the ~/todo or ~/project directory in a repo to be the same in all branches (that way you can update them no matter what branch you're on.)